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PREFACE 



This publication describes the Device Support Facilities 

processor and commands. It also discusses hardware 

consi derat i ons, operating system considerations, and planning 

and installation. It is written for installation managers* 

system programmers, system operators, and other data processing 

personnel who manage or use direct access storage devices 

(DASD). 



Wherever an IBM operating system is discussed, it 
readers understand the concepts and terms used in 
system. 



is assumed 
that operating 



MAJOR DIVISIONS OF THIS PUBLICATION 



For convenience, information on Device Support Facilities is 
presented under two major headings : 

• "Part 1. General Information" describes Device Support 

Facilities and how it is used by the system programmer and 
the system operator. 



"Part 2. Reference Information" describes in detail 
syntax and function of the Device Support Facilities 

commands. 



the 



Appendix A contains description and figures showing volume 
layout and record formats. Appendix B describes support for the 
minidisk under VM/370. Appendix C lists and explains Device 
Support Facilities messages. Appendix D contains problem 
determination information. Appendix E describes the VTOC index, 
and gives information on calculating the size of the index data 
set . 



CONVENTIONS USED IN THIS PUBLICATION 



The illustrations of command formats in this book use the 
following conventions: 

Brackets ([]) indicate an optional field or parameter. 

Braces ({}) indicate that one of alternative items must be 
selected. 

Items separated by a vertical bar (|) represent alternative 
items. Only one item may be selected. 

An ellipsis (•••) indicates that multiple entries of the 
type immediately preceding the ellipsis are allowed. 

Boldface type indicates the exact characters to be entered. 
Such items must be entered as shown or in the abbreviated 
form allowed. 

Underscored uppercase type indicates a default option. If 
the parameter is omitted, the default value is assumed. 

Underscored lowercase or lowercase type indicates fields to 
be supplied by you. 

Parentheses, commas, slashes, spaces, and other punctuation 
must be entered as shown. 
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Numeric parameters can be coded in two ways'- decimal or 
hexadecimal (X'n f ). This applies to any parameter that 
specifies a substitution of decimal numbers. 

Character string parameters can be coded either with or 
without enclosing them in single quotation marks. However* 
if delimiters such as commas* blanks, or parentheses appear 
within a character string, the string must be enclosed 
within single quotation marks. 



PREREQUISITE PUBLICATIONS 



IBM Svstem/370 and 4300 Processors Bibliography , GC20-0001, 
describes the publications that are applicable and current for 
OS/VS and DOS/VSE operating systems. 



RELATED PUBLICATIONS 



Other books that may be helpful to you are' 

Device Support Facilities Logic , SY35-0030, describes the 
program logic of Device Support Facilities. 

IBM 3850 Mass Storage System (MSS) Introduction and 

Prei nstallat i on , Planning , GA32-0038, introduces the concepts 

of the Mass Storage System. 

Operator's Library' IBM 3850 Mass Storage System (MSS) 
Under OS/VS , GC35-0014, describes commands used with the 
Mass Storage System. 

Data Facility Device Support* User's Guide and Reference , 
SC26-3952, describes the index to the table of contents 
(VTOC) and tells how the index is created and used. 

0S/VS2 MVS Resource Access Control Facility CRACF) General 
Information Manual , GC28-0722, describes the functions and 
capabilities of access control. 

0S/VS2 System Programming Library* Supervisor , GC28-0628, 
describes the authorized program facility and service 
management (SRB dispatching). 

Component Summary — 1835 Storage Control, 2305 Fixed Head 
Storage , GA26-1589, describes the 2305 direct access storage 
devi ce. 

IBM System 360 — Component Descriptions, 2314 Direct Access 
Storage Facility and 2844 Auxiliary Storage Control , 
GA26-3599, describes the 2314 direct access storage device. 

IBM 2319 Disk Storage — A Series, Component Description , 
GA26-1606, describes the 2319 direct access storage device. 

IBM 3310 Direct Access Storage Reference Manual , GA26-1660, 
describes the 3310 fixed block storage device. 

Reference Manual for IBM 3350, A Series, Disk Storage , 
GA26-1615, describes the 3330 direct access storage devices. 

Reference Manual for IBM 3340-3344 Disk Storage , GA26-1619, 
describes the 3340 and 3344 direct access storage devices. 

Reference Manual for IBM 3350 Direct Access Storage , 
GA26-1638, describes the 3350 direct access storage device. 
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Introduction to IBM 3370 Direct Access Storage * GA26-1657, 
describes the 3370 storage system and its fixed block data 
format. 

Introduction to 3375 Direct Access Storage * GA26-1666* 
describes the 3375 direct access storage device. 

IBM 3380 Direct Access Storage Description and User's Guide * 
GA26-1664, describes the 3380 direct access storage device. 
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SUMMARY OF AMENDMENTS 



RELEASE 4.0 



NEW SUPPORT 



The IBM 3375 is now supported in the stand-alone, 0S/VS1, and 
0S/VS2 MVS environments. 

For the IBM 3375 and 3380, skip displacement can now be 
performed. Device Support Facilities will skip over defects on a 
track in lieu of assigning an alternate track. Skip displacement 
is performed by the INIT command at the maximal level if an 
error i s encountered, and by the INSPECT command when you 
specify CHECK with TRACKS. 



CHANGES TO COMMANDS 



The DEVICETYPE parameter has been deleted from the ANALYZE, 
MAPALT, and REFORMAT commands. With the INIT and INSPECT 
commands, the DEVICETYPE parameter is only required when you use 
these commands with the MIMIC(MINI) or MIMIC(EMU) option. 



OTHER CHANGES 



In the stand-alone environment, you can identify the input 
and/or output device to ICKDSF by specifying CARD or PRNT 
instead of the actual device. ICKDSF then selects the 
appropriate input and/or output device respectively. 

| Updates have been made throughout Appendix C. 

| Editorial updates have been made throughout. 



JANUARY 1981 



OCTOBER 1980 



3380 



Editorial changes have been made. Since no new function has been 

added, technical changes that were made for Device Support 

Facilities 3.0 are still indicated by a vertical bar to the left 
of the change. 



Editorial changes have been made. New function has been added as 
noted below. 



The IBM 3380 Direct Access Storage Device is now supported in 
the 0S/VS1, 0S/VS2, and stand-alone environments. 
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ANALYZE COMMAND 



A new parameter, MSS, has been added that may be specified when 
ANALYZE is executed against an emulated 3330-11 mass staging 
volume that resides on an IBM 3350 Direct Access Storage Device 



BUILDIX COMMAND 



INIT COMMAND 



MAPALT COMMAND 



A new command has been added to build a VTOC index on count key 
data devices (except the IBM 2314 Direct Access Storage 
Faci 1 i ty) . 



A new parameter, INDEX, has been added to allow the creation of 
a VTOC index when the volume is initialized. 



A new command has been added to produce a report of primary 
blocks assigned to alternate blocks on fixed block architecture 
devi ces. 



VTOC, DOSVTOC, TRACKS PARAMETERS 



Syntax for these three parameters has been changed to make them 
more consistent with the other parameters. 
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PART 1. GENERAL INFORMATION 



Part 1. General Information 



INTRODUCTION 



Device Support Facilities is a program used with IBM System/370 
operating systems to perform various operations on direct-access 
storage devices. It can initialize a direct-access storage 
volume so that it can be used in an OS/VS or a DOS/VSE system, 
inspect a volume for defective tracks, reformat the volume label 
and IPL bootstrap and program records, and examine a device with 
a nonremovable storage mechanism to determine if there are 
problems with the drive or with reading or writing data stored 
on the volume. 

Device Support Facilities operates under 0S/VS1, 0S/VS2 MVS, and 
DOS/VSE, and as a stand-alone program. It also operates under VM 
where an 0S/VS1 or 0S/VS2 system has been IPLed and the 
direct-access device to be referred to in the Device Support 
Facilities command is presented to the VM system via the ATTACH 
command. 

Device Support Facilties supports the following devices: 

2305 Fixed Head Storage Models 1 and 2 (2305-1, 2305-2) 

2311 Disk Storage Model 1 (2311) 

2314 Direct Access Storage Facility (2314) 

2319 Disk Storage Models Al, A2, and A3 (2319) 

3310 Direct Access Storage (3310) 

3330 Disk Storage Models 1 and 2 (3330) 

3330 Disk Storage Model 11 (3330-11) 

3330V MSS 3330 Virtual Volume 

3333 Disk Storage and Control Models 1 and 11 (3330, 
3330-11) 

3340 Direct Access Storage Facility (3340) 

3344 Direct Access Storage (3344) 

3350 Direct Access Storage (3350) 

3370 Direct Access Storage (3370) 

3375 Direct Access Storage (3375) 

3380 Direct Access Storage (3380) 

See Figure 2 on page 4 for information on devices supported by 
specific Device Support Facilities commands. 



CONSIDERATIONS FOR STAGING DEVICES 



Before Device Support Facilities can be run against a staging 
device, and before the drive can be accessed, the device must be 
in offline real status. See the manual Operator's Library: IBM 
3850 Mass Storage System (MSS) Under OS/VS for details of the 
VARY OFFLINE, TEST command that is used to set up the device for 
nonstaging access. 
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INSTALLATION INFORMATION 



Instructions explaining how to install Device Support Facilities 
are contained in the program directory shipped with the 
machine-readable material. 



STORAGE REQUIREMENTS 



Device Support Facilities requires the following estimated 
amounts of storage space in the 0S/VS1 and 0S/VS2 MVS 
envi ronments*- 

• Main storage? 384K bytes 

• Auxiliary storage- 200K bytes 

In the DOS/VSE environment, Device Support Facilities requires a 
minumum partition size of 384K bytes. 



DEVICE SUPPORT FACILITIES COMMANDS 



Device Support Facilities has six commands? The BUILDIX, INIT, 
INSPECT, and REFORMAT commands are used with count key data 
devices. The MAPALT command is used with fixed block 
architecture devices. The ANALYZE command is used with both 
fixed block and count key data devices. 

• ANALYZE is used for nonremovable storage media to determine 
if there are any problems with the drive or with reading the 
user data recorded on the volume. ANALYZE is supported on 
0S/VS1, 0S/VS2 MVS, and DOS/VSE, and in the stand-alone 
environment. See Figure 2 on page 4 for devices supported by 
the ANALYZE command. 

• BUILDIX changes a standard OS format VTOC to an indexed 
VTOC, or it can change an indexed VTOC to an OS/VS VTOC. 

• INIT initializes a direct-access storage volume so that it 
can be used in an OS/VS system, a DOS/VSE system, or a 
stand-alone system, or it reinitializes a volume that was 
previously initialized. 

• INSPECT inspects a previously initialized volume for 
defective tracks. 

• MAPALT produces a report showing the assignment of primary 
blocks to alternate blocks on fixed block architecture 
devices used in DOS/VSE or stand-alone systems. 

• REFORMAT reformats the volume label, IPL bootstrap, and IPL 
program records of a previously initialized volume for an 
OS/VS, DOS/VSE, or stand-alone system. 

Figure 1 on page 4 displays these commands and indicates the 
operating systems each command supports. 

Figure 2 on page 4 displays the commands and indicates the 
devices each command supports. It also indicates which devices 
have fixed block architecture. In both figures, an X denotes 
support and a hyphen (-) denotes nonsupport. Sections following 
the figures give an overview of the commands. 
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Figure 1. Operating Systems Supported by ICKDSF Commands 
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Figure 2. Devices Supported by ICKDSF Commands 



Note that the following devices are supported only in certain 
envi ronments^ 

• The 2311, 3310, and 3370 are supported by DOS/VSE and 
stand-alone. 



The 2305 is supported by 0S/VS1, 0S/VS2 MVS, and 
stand-alone. 

The 3330 MSS virtual volume (3330V) is supported by the INIT 
command in a stand-alone environment when the MIMIC(MINI) 
parameter is also specified. The 3330V is also supported by 
the BUILDIX command in the 0S/VS1 and 0S/VS2 MVS 
envi ronments. 



The 3375 is supported by 0S/VS1, 0S/VS2 MVS, and 
stand-alone. 

The 3380 is supported by 0S/VS2 MVS and stand-alone, 
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ANALYZING A VOLUME UITH NONREMOVABLE STORAGE MEDIA 

When error messages indicate a problem with a DASD device having 
nonremovable storage media* the ANALYZE command can help the 
user determine whether to continue operating the device or to 
start the installation's recovery procedures. 

Examples of messages that indicate equipment or data problems 

are '• 

• In an OS/VS system: 

A supervisor message such as IEA000I ... 

• In a DOS/VSE system: 

A DASD error message such as 8121 I ... 

ANALYZE is used in an OS/VS or DOS/VSE operating system, or in 
the stand-alone environment, to examine the storage device to 
determine if there are drive problems or storage media problems. 
A drive problem is an equipment failure within the device that 
prevents data from being written correctly on the storage media 
or from being read correctly once it has been written. A storage 
media problem is a failure on the magnetic surface of the 
device's disk — some of the data can be written and read 
correctly, other data on the same surface cannot. 

ANALYZE examines the device and, based on the sense information 
returned, determines the type of problem. It then issues the 
appropriate message. 

If ANALYZE does not detect a problem and you continue to have 
errors in the data read from the drive, you may assume that the 
condition is either intermittent or results from incorrect data 
or faulty programming. 

Note that ANALYZE helps determine if recovery actions are 
needed, but does not initiate recovery procedures to repair the 
drive or its data. It is expected that the user's own data 
backup and recovery strategy will be provided. 



BUILDING AN INDEX FOR THE VOLUME TABLE OF CONTENTS 

In OS/VS systems having indexed VTOC programming support, the 
BUILDIX command can be used to change a standard OS format VTOC 
on a count key data device to a VTOC with an indexed format. 
(The abbreviations OSVTOC and IXVTOC, when used in this book, 
refer to these two formats of the VTOC. These abbreviations are 
used also in system messages and to designate parameters of the 
BUILDIX command. ) 

The BUILDIX command is used to: 

• Change an OS format VTOC to an indexed VTOC 

• Change the indexed VTOC to an OS format VTOC 
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INITIALIZING A VOLUME 



The INIT command can be used to initialize a count key data 
direct-access storage volume so that it can be used in an OS/VS 
or DOS/VSE operating system. Initialization can be at a minimal, 
medial, or maximal level depending on the command parameters 
specified by the user. Command parameters &re discussed in 
detail in "Part 2. Reference Information." 

The INIT command is used to : 

• Check the track surfaces and assign alternate tracks to 
defective tracks 

• Reclaim tracks that were previously flagged defective if the 
results of surface checking shows there are no recording 
errors 

• Write a volume label and reserve space for additional user 
volume-label records 

• Write a volume serial number in the volume label 

• Write an owner identification in the volume label 

• Write a volume table of contents (VTOC) and reserve space 
for additional entries 

• Write IPL bootstrap records and an IPL program 

• Validate the home address and record for each track 

• Write an index for the VTOC mentioned above, thereby 
creating an indexed VTOC. 



INSPECTING A VOLUME 



After initializing a volume, you can use the INSPECT command to 
inspect a volume for defective tracks, to assign alternate 
tracks, or to reclaim tracks that were previously flagged 
defective. 

The INSPECT command is used to ; 

Conditionally assign alternate tracks based on the results 
of surface check 

Unconditionally assign alternate tracks 

Conditionally reclaim primary or alternate tracks 

Conditionally reassign alternate tracks based on results of 
surface check 

Unconditionally reassign alternate tracks 



MAPPING ALTERNATE BLOCK ASSIGNMENTS 



In a DOS/VSE operating system or in the stand-alone environment, 
the MAPALT command can be used on fixed block architecture 
direct access storage devices to produce a printed report, or 
map, showing primary blocks on the device that have alternate 
blocks assigned. A limited range of blocks to be mapped may be 
specified, if desired. 
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MAPALT output includes^ 

• A summary report showing the number of blocks with 
alternates assigned. 

• An optional detailed report showing the relative block 
number of the defective primary block, its location on the 
volume, and the location on the volume of the assigned 
alternate. 

• Diagnostic information, if I/O errors cause interruption of 
program execution 



REFORMATTING A VOLUME 



After a volume has been initialized, the REFORMAT command can be 
used to change the volume serial number, owner identification, 
and IPL bootstrap and program records. Also, if an IPL program 
record does not already exist on the volume, one can be added. 
Only volumes that have been initialized can be reformatted. 

The REFORMAT command is used to»" 

• Write a new volume serial number in the volume label 

• Write a new owner identification in the volume label 

• Write IPL bootstrap records at cylinder 0, track 0, records 
1 and 2 and replace or add an IPL program 



DATA SET SECURITY AND PROTECTION 

Device Support Facilities commands are used to manage 
direct-access storage volumes. There is danger of serious damage 
to data through inadvertent manipulation of a volume. For this 
reason, it is important to have some means of protecting data. 
With Device Support Facilities there are several degrees of 
volume and data set protection. 

There are two environments in which Device Support Facilities 
can execute- in an operating system or in a stand-alone 
environment. In the OS/VS operating systems, two modes of 
operation are available: offline and online. In a stand-alone 
environment, only the offline mode is available. In a DOS/VSE 
environment, only the online mode is available. Data set 
security and protection in different environments and with 
different modes of operation are discussed in the following 
sect i ons. 

Note that the ANALYZE command does not expose data on the volume 
to unauthorized disclosure, modification, or destruction, since 
the ANALYZE command does not write on any user data tracks and 
does not transmit any user data from the device under test. 

DATA SET SECURITY AND PROTECTION IN AN OFFLINE MODE (OS/VS) OR IN A STAND-ALONE 
ENVIRONMENT 

Data set security and protection are limited in offline mode or 
in a stand-alone environment to what is indicated below : 

• The VERIFY parameter of the INIT, INSPECT, and REFORMAT 

commands can be specified to ensure that the volume serial 
number and owner identification supplied in the command 
match those found on the volume. If they match, execution of 
the command continues; if they do not match, execution of 
the command terminates. 
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• The PURGE parameter of the INIT command can be specified. 
Before the command starts processing the volume, the 
operator is requested to confirm that the contents of the 
volume can be purged (see message ICK003D in "Appendix C. 
Device Support Facilities Messages"). If the operator 
confirms that the volume contents can be purged, they are 
purged without consideration as to whether the data is 
contained in unexpired data sets, VSAM data sets, 
password-protected data sets, or RACF-protected data sets. 

DATA SET SECURITY AND PROTECTION IN AN ONLINE MODE (OS/VS) 

Because the resources of the operating system are available to 
Device Support Facilities in an online mode, data set security 
and protection are greater. 

The VERIFY parameter of the INIT, INSPECT, and REFORMAT commands 
can be specified to ensure that the volume serial number and 
owner identification supplied in the command match those found 
on the volume. If they match, execution of the command 
continues; if they do not match, execution of the command 
terminates. The VERIFY parameter causes the same result in 
either online or offline mode (OS/VS environment) or in a 
stand-alone environment. 

The NOPURGE parameter of the INIT command can be specified. 
Execution of the command terminates if unexpired data sets, 
password-protected data sets, RACF-protected data sets, or VSAM 
data sets are found on the volume. 

The PURGE parameter of the INIT command or the NOPRESERVE 
parameter of the INSPECT command can be specified. If unexpired 
data sets, password-protected data sets, RACF-protected data 
sets, or VSAM data sets are on the volume, data loss is 
prevented as follows- 

• Unexpired data sets ' The operator is requested to confirm 
that the contents of the volume can be purged (see message 
ICK001D in "Appendix C. Device Support Facilities 
Messages"). Only one request is made, regardless of the 
number of unexpired data sets on the volume. Note that a 
list of the unexpired data sets is not provided. 

• Password-protected data sets : The operator must provide the 
correct password for each password-protected data set on the 
volume. If the correct password is not supplied, execution 
of the command terminates. Note that a data set that is 
password-protected and unexpired will be purged if the 
password is supplied, even though the expiration date has 
not been passed. If a data set is RACF-protected and 
password-protected, the data set password is bypassed, and 
only RACF protection is provided. 

Because of the number of requests for passwords, it may be 
less time-consuming to process the volume on a device that 
is offline to the operating system. 

• RACF-protected data sets ; The RACF program determines if 
the user is authorized to access the volume contents. When 
the user is authorized for full volume access, the command 
continues processing. If the user is not so authorized, the 
command terminates unless the user has authority to access 
data sets. If the user has data set authorization, the RACF 
program determines for each data set whether the user is 
authorized to scratch the data set. If so, the command is 
executed. Should any data set be found that the user is not 
authorized to scratch, execution of the command terminates. 
If a data set is both RACF protected and password protected, 
the password will be checked only if RACF support is not 
present in the system. The system operator usually has the 
authority to bypass RACF checking. 
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• VSAM data sets ' In the online mode, when VSAM data sets 
exist on the volume, processing terminates and a message is 
issued. If this volume is to be reinitialized, it is 
necessary to do so in the offline mode. 

AUTHORIZED PROGRAM FACILITY (0S/VS2 MVS ONLY) 

The authorized program facility (APF) limits the use of 
sensitive system services and resources to authorized system and 
user programs. See "Authorized Program Facility (APF)" in QS/VS2 
System Programming Library' Supervisor for information about 
program authorization. 

The Device Support Facilities load module is contained in 
SYS1.LINKLIB, except module ICKDV05 (IGG019P2), which is 
contained in SYS1.SVCLIB. The load module (ICKDSF) is 
link-edited with the SETCODE AC(1) attribute. These two 
characteristics ensure that Device Support Facilities executes 
with Authorized Program Facility authorization. 

This authorization is established at the task level. If, during 
the execution of an APF-authori zed job step, a load request is 
satisfied from an unauthorized library, the task will be 
abnormally terminated. It is the installation's responsibility 
to ensure that a load request cannot be satisfied from an 
unauthorized library during Device Support Facilities 
processi ng. 

If a Device Support Facilities module is loaded from an 
unauthorized library, the Authorized Program Facility 
authorization of Device Support Facilities terminates. 

DATA SET SECURITY AND PROTECTION (DOS/VSE) 

The VERIFY parameter of the INIT, INSPECT, and REFORMAT commands 
can be specified to ensure that the volume serial number and 
owner identification supplied in the command match those found 
on the volume. If they match, execution of the command 
continues; if they do not match, execution of the command 
termi nates. 

The NOPURGE parameter of the INIT command can be specified. 
Execution of the command terminates if unexpired files, 
data-secured files, or VSAM files are found on the volume. 

The PURGE parameter of the INIT command or the NOPRESERVE 
parameter of the INSPECT command can be specified. If unexpired 
files, data-secured files, or VSAM files are on the volume, data 
loss is prevented as follows 5 

• Unexpired files - The operator is requested to confirm that 
the contents of the volume can be purged (see message 
ICK001D in "Appendix C. Device Support Facilities 
Messages"). Only one request is made, regardless of the 
number of unexpired files on the volume. Note that a list of 
the unexpired files is not provided. 

• Data-Secured files 1 If a file is a data-secured file, 
message ICK010D prompts the operator with the name of the 
secured file, and message ICK011D requests permission to 
purge the file. This sequence is repeated for each 
data-secured file that exists on the volume. 

• VSAM f i les : If a single VSAM file is found on the volume, 
permission is requested for the purging of all the VSAM 
files on the volume (message ICK012D). 
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PROCESSING IN A SHARED ENVIRONMENT (OS/VS) 



The commands INIT, INSPECT, REFORMAT, and BUILDIX require 
exclusive control of the direct access storage volume. Hence, 
the device is reserved by issuance of the RESERVE macro to the 
processor that issued the command. After processing on that 
device is completed, the DEQ macro is issued to release the 
devi ce. 



PROCESSING IN A SHARED ENVIRONMENT (DOS/VSE) 



For all commands, processing continues only after the operator 
has replied to a console message (ICK020D) granting permission 
to process on the device that is being shared. 
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EXECUTING DEVICE SUPPORT FACILITIES 



To use Device Support Facilities, you execute the Device Support 
Facilities command processor. Each command is processed 
completely before processing of another command begins. 

The following sections describe execution of Device Support 
Facilities in several situations* 

• In the stand-alone environment 

• In an OS/VS environment 

• In a DOS/VSE environment 



EXECUTING DEVICE SUPPORT FACILITIES IN A STAND-ALONE ENVIRONMENT 

You execute the Device Support Facilities program in a 
stand-alone environment by loading the program into main 
storage. The examples in Part 2 of this book illustrate each 
command's use after the program is loaded. 



LOADING THE DEVICE SUPPORT FACILITIES PROGRAM 

For OS/VS (both VS1 and VS2), the stand-alone code is found in 

SYS1.SAMPLIB in ICKSADSF. The Device Support Facilities program 

is usually loaded from a file on tape, but can be loaded from a 
binary-card deck. 

The following is sample OS/VS JCL that can be used to copy the 
stand-alone Device Support Facilities code to an unlabelled 
tape. There should only be one file on the tape. Note that 
BLKSIZE=80 is required on the tape data set. 

//JOBNAME JOB JOB CARD PARAMETERS 

//STEPNAME EXEC PGM=IEBGENER 

//SYSPRINT DD SYS0UT=A 

DUMMY, DCB=BLKSIZE=80 

DSNAME = SYS1. SAMP LIB (ICKSADSF), UNI T = 3330, 

DISP=SHR,VOLUME=SER=XXXXXX, 

DSNAME=ICKDSF, UNI T=240 0-3, L ABEL =(,NL), 

DISP=(,KEEP),VOLUME=SER=YYYYYY, 

DCB=(RECFM=F,LRECL=80,BLKSIZE=80) 

In the DOS/VSE environment, the stand-alone code is found in the 
system source statement library in book Z.DSFSA. You can copy 
the code to a tape by using the DOS/VSE BACKUP utility. The 
following shows sample job control statements to copy the 
stand-alone Device Support Facilities code to a tape. 

// JOB BUILD A STAND-ALONE TAPE 

// ASSGN SYS006,cuu OUTPUT TAPE FOR STAND-ALONE DSF 

// MTC REW,SYS006 

// EXEC BACKUP 

SA 
/* 
/& 



//SYSIN 


DD 


//SYSUT1 


DD 


// 




//SYSUT2 


DD 


// 




// 
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Because the procedures for loading a program are not the same 
for all models of processing units, you must load the Device 
Support Facilities program from the tape unit or card reader 
according to the procedures for your processing unit. The 
program contains the instructions necessary to load and store 
itself in the lower addresses of main storage. When the program 
has completely loaded, the processor enters the WAIT state. When 
the processor enters the WAIT state, the program status word 
(PSW) should contain the following: 

FF060000 OOFFFFFF 

At this time, you continue by identifying the console, the input 
device, and the output device. 



Identifying the Console 



You identify the console to the program by pressing the REQUEST 
or ENTER key at the console. You must use one of the following 

consoles 1 

1052 Model 7 Printer-Keyboard 

3036 Graphics Console 

3056 Graphics Console 

3138, 3148, 3158 Consoles in typewriter keyboard mode 

3210 Models 1 and 2 Console Printei — Keyboard 

3215 Model 1 Console Printei — Keyboard 

3277-2 Graphics Console 

3278-2A Graphics Console 



Identifying the Input Device 



After you have identified the console, message ICK005E prompts 
you to specify the input device and its address. See Appendix C 
for the full message text. You must use one of the following 
input devices^ 

1052 Model 7 Printer-Keyboard 

1442 Model Nl Card Read Punch, Model N2 Card Punch 

2501 Models Bl and B2 Card Reader 

2520 Model Bl Card Read Punch, Models B2 and B3 Card Punch 

2540 Model 1 Card Read Punch 

2560 Multifunction Card Machine 

3210 Models 1 and 2 Console Printei — Keyboard 

3215 Model 1 Console Printei — Keyboard 

3504 Models Al and A2 Card Reader 

3505 Models Bl and B2 Card Reader 
3525 Card Punch (with card-read feature) 

5424 Card Punch (80 columns only) 

5425 Multifunction Card Unit (80 columns only) 
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You can specify the word CARD or one of the device types listed 
above or you can specify the console as the input device by 
entering CONSOLE in response to message ICK005E. When the 
console is the input device, you are prompted to enter the next 
line by 'ENTER INPUT/COMMAND'. 



Identifying the output Device 



After you respond to message ICK005E, message ICK006E prompts 
you to specify the output device and its address. See Appendix C 
for the full message text. You must use one of the following 
output devices^ 

1052 Model 7 Printer-Keyboard 

1403 Models 2, 7, and Nl Printer 

1443 Model Nl Printer 

3203 Models 1, 2, 4, and 5 Printer 

3210 Models 1 and 2 Console Printei — Keyboard 

3211 Model 1 Printer 

3215 Model 1 Console Printer-Keyboard 

3800 Printing Subsystem 

3262 Line Printer 

3289 Model 4 Printer 

5203 Model 3 Printer 

You can specify the word PRNT or one of the devices listed above 
or you can specify the console as the output device by entering 
CONSOLE in response to message ICK006E. 



Specifying the Date and Time of Day 



The date and time of day are automatically picked up from the 
TOD (time of day) clock of the processing unit. Note that the 
TOD clock would typically indicate Greenwich Mean Time, and this 
would be reflected in any listings. 

In the event that the TOD clock is in error or not set, message 
ICK015E prompts you to enter the date. Then, message ICK016E 
prompts you to enter the time of day. In response to these 
messages, you can enter any string of up to 8 characters. These 
will appear in the title line of the output. On the other hand, 
you can press the ENTER key without specifying a date or time of 
day. In this case, the time of day and date are set to zeros. 
Note that these messages can appear again if a VTOC entry has to 
be created for a data set. It is necessary to furnish the 
information each time it is requested if the VTOC entry is to be 
correct . 



ERROR CONDITIONS 



The stand-alone version of Device Support Facilities requires 
384K bytes of real storage to execute successfully. In the event 
that the real storage available for Device Support Facilities is 
not sufficient, all the input is read and an error condition is 
posted in the PSW. This error condition is* 

00020000 33222222 

A PSW code of 

00020000 22222222 
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indicates that a unit check occurred on the IPL device during 
the IPL. 

The PSW indicates the cause of errors that may occur when 
processing Device Support Facilities in a stand-alone 
environment. The processor is placed in a WAIT state and the PSW 
contains the following: 

FF060000 OOEEEEnn 

Values of nn indicate the type of error: 



13' indicates an SVC interrupt 

14' indicates a program interrupt 

15' indicates insufficient main storage 

16" indicates an I/O error 

17' indicates data set not open 

18* indicates console not defined 

19* indicates no end-of-data routine 



PROGRAM TERMINATION 



Execution of the Device Support Facilities program terminates in 
a stand-alone environment when the end of the command input 
stream is encountered. If the console was specified as the input 
device, you enter the characters EOF in response to a request 
for the next command. When the execution terminates, the 
processor is placed in a WAIT state, and the PSW should contain 
the following: 

FF060000 OOEEEEsz 

where zz. indicates the highest decimal condition code 
encountered during execution as shown by the hexadecimal values 
that appear next. See "Condition Codes to Control Command 
Execution" later in this chapter for an explanation of condition 
codes. 

X'OO' indicates 

X'04' indicates 4 

X'08» indicates 8 

X'OC* indicates 12 

X'10* indicates 16 



EXECUTING DEVICE SUPPORT FACILITIES IN OS/VS 



In the OS/VS environment you execute Device Support Facilities 
as a job or job step. The examples in Part 2 of this book 
illustrate each command's use by obtaining the processor using 
OS/VS JCL statements. 

You identify the Device Support Facilities processor when you 
state PGM=ICKDSF in the EXEC statement. 
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//JOBNAME JOB YOUR INSTALLATION'S JOB-ACCOUNTING DATA 
DSNAME=YOUR. CATALOG, DISP=SHR 
PGM=ICKDSF 

UNIT=(davicetype),DISP=0LD,V0L=SER=V0L123 
DSNAME=ANOTHER. CATALOG, DISP=SHR 
SYSOUT=A 
* 



//JOBCAT 


DD 


//STEP1 


EXEC 


//MYVOL 


DD 


//STEPCAT 


DD 


//SYSPRINT 


DD 


//SYSIN 


DD 



Device Support Facilities commands 



/* 



JOB CONTROL LANGUAGE EXPLANATION 



6. 



//JOBNAME is required. The JOB statement describes your job 
to the OS/VS system. Procedures at your installation may 
require you to supply user identification, accounting, and 
authorization information with the JOB statement's 
parameters. 

//JOBCAT is optional. The JOBCAT DD statement identifies a 
user catalog that can be used by each of the job's steps. If 
your job uses only the master catalog, do not specify the 
JOBCAT DD statement since the master catalog is always open 
and available to all the jobs on the system. 

//STEP1, an EXEC statement, is required. The EXEC statement 
invokes the Device Support Facilities processor to process 
the Device Support Facilities commands. 

//STEPCAT is optional. The STEPCAT DD statement identifies a 
user catalog that can be used when processing the job step. 
If user catalogs are identified with JOBCAT and STEPCAT DD 
statements, only the catalog identified with the STEPCAT DD 
statement and the master catalog are used with the job step. 
If your job step uses only the master catalog, do not 
specify the STEPCAT DD statement, because the master catalog 
is always open and available to all the jobs on the system. 

//SYSPRINT is required. The SYSPRINT DD statement identifies 
the output data set that Device Support Facilities sends 
messages and output information to. (See "Output Data Sets" 
later in this chapter for more information on how to 
describe an output device other than SYSOUT=A.) 

//SYSIN is required. The SYSIN DD statement identifies the 
source of the input statements. An input statement to Device 
Support Facilities is a command. When you code SYSIN DD *, 
you identify the statements that follow as input. 

The last input statement is followed by /* in the first two 
columns of the next input record. 



PRINTED OUTPUT DATA SET 



The normal printed output data set is 
parameters for this data set are: 

• Record format of VBA 



SYSPRINT. The default 



• Logical-record length of 125 (121 + 4) 

• Block size of 629 (5 x (121 + 4) + 4) 

The first byte is the ANSI control character. The minimum 
specifiable logical-record length (LRECL) is 121 (U-format 
records only ) . If a smaller size is specified, it will be 
overridden to 121. 

You can alter the above defaults by specifying the desired 
values in the DCB parameter of the SYSPRINT statement. However, 
the record format cannot be specified as F or FB. If you specify 
either of these, it will be changed to VBA. 
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EXECUTING DEVICE SUPPORT FACILITIES IN DOS/VSE 

You execute Device Support Facilities as a job. The examples in 
Part 2 of this book i llustrate each command's use by obtaining 
the processor with system control statements. You identify 
Device Support Facilities in the EXEC statement by stating EXEC 
ICKDSF. 

// JOB jobname YOUR INSTALLATION'S JOB-ACCOUNTING DATA 

// ASSGN SYS010,353 

// EXEC ICKDSF, SIZE=256K 

Device Support Facilities commands 
/* 
/& 

SYSTEM CONTROL STATEMENTS EXPLANATION 

1. // JOB is an optional statement used to describe your job to 
the DOS/VSE system. 

2. // ASSGN causes the SYSNAME SYS010 to be assigned to the 
device whose channel and unit address is 353. 

3. /* appears in the first two columns of the input record 
following the last input statement. 

4. /& appears in the first two columns of the input record 
following the /* card to indicate end of job. 



PRINTED OUTPUT 



All printed output is directed to SYSLST. 



CONTROLLING COMMAND EXECUTION 



Command execution can be controlled by the statements that 
follow^ 

• The IF-THEN-ELSE statement sequence tests a condition code 
and controls execution of subsequent commands according to 
the results of the test. The IF statement is followed by 
THEN and ELSE clauses, which specify alternative actions. DO 
and END statements are optionally part of THEN and ELSE 
clauses and specify the beginning and ending of a statement 
sequence when you want to specify more than one Device 

• Support Facilities command with either a THEN or an ELSE 
clause. 

• The SET statement sets condition codes. 



CONDITION CODES TO CONTROL COMMAND EXECUTION 



The condition codes compared in the IF-THEN-ELSE statement 
sequence are LASTCC and MAXCC, which take the following values* 



indicates that the command was executed as specified. Some 
informational messages may have been issued. 

indicates that some problem was met while executing the 
complete command, but Device Support Facilities processing 
continued. The continuation might not provide the user with 
exactly what was wanted, but no data or volume has been 
permanently harmed. A warning message was issued. An 
example of the kind of problem encountered is: the system 
ignored a parameter that was specified but did not apply. 
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16 



indicates that a requested command was completed, but some 
actions were unavoidably bypassed. For example, Device 
Support Facilities was unable to reclaim an alternate 
track. 

indicates that the requested command could not be executed. 
This condition code is a result of a logical error or a 
problem during execution. A logical error exists, for 
example* when inconsistent parameters are specified, when a 
too-small or too-large value is specified, or when required 
parameters are missing. A problem during execution exists 
when the volume label cannot be changed. 

indicates a severe error occurred, causing the remainder of 
the command stream to be flushed. For example, this 
condition code might be a result of the following! the 
system output data set could not be opened (the SYSPRINT DD 
statement was missing, perhaps); an unrecoverable error 
occurred in a system data set; or Device Support Facilities 
encountered improper IF-THEN-ELSE statement sequences. 



IF-THEN-ELSE STATEMENT SEQUENCE 



You use the IF-THEN-ELSE statement sequence to control command 
execution. The syntax of the IF-THEN-ELSE statement sequence is 



IF 



(LASTCC comparison operator 
condition code I 
MAXCC comparison operator 
condition code) 



THEN [command | 
DO 

command 
END1 



[ELSE: C command | 
DO 

command 
END]] 



where •' 

IF specifies that one or more Device Support Facilities commands 

are to be executed based on a test of a condition code value. 

The condition code was set by a SET command or reflects the 

completion status of previous Device Support Facilities 
commands. 

LASTCC comparison operator condition code specifies that the 

condition code value resulting from the immediately previous 

Device Support Facilities command is to be compared to the 

condition code indicated by the comparison operator to determine 

whether the THEN or ELSE action is to be performed. See 
"Condition Codes to Control Command Execution" earlier in this 
chapter for the explanation of condition codes. 

For comparison operator , substitute one of the following six 
comparison operators to compare the condition code resulting 
from the previous Device Support Facilities command and the 
condition code you specified in the IF statement: 

• Equal, specified as = or EQ 

• Not equal, specified as -= or NE 
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• Greater than, specified as > or GT 

• Less than, specified as < or LT 

• Greater than or equal, specified as >= or GE 

• Less than or equal, specified as <= or LE 

For condition code , substitute the decimal number, up to ten 
digits long, that is to be compared with LASTCC. Condition codes 
greater than 16 Qre reduced to 16. See "Condition Codes to 
Control Command Execution" earlier in this chapter for the 
explanation of condition codes. 

HAXCC comparison operator condition code specifies that the 
maximum condition code value resulting from any previous Device 
Support Facilities command or a SET command is to be compared to 
the condition code indicated by the comparison operator to 
determine whether the THEN or ELSE action is to be performed. 
See "Condition Codes to Control Command Execution" earlier in 
this chapter for the explanation of condition codes. 

Fo r comparison operator , substitute one of the following six 
comparison operators to compare the maximum condition code 
resulting from any Device Support Facilities command and the 
condition code you specified in the IF statement: 

Equal, specified as = or EQ 

Not equal, specified as -= or NE 

Greater than, specified as > or GT 

Less than, specified as < or LT 

Greater than or equal, specified as >= or GE 

Less than or equal, specified as <= or LE 

For condition code , substitute the decimal number, up to ten 
digits long, that is to be compared with MAXCC. Condition codes 
greater than 16 are reduced to 16. See "Condition Codes to 
Control Command Execution" earlier in this chapter for the 
explanation of condition codes. 

THEN specifies that a single command (or a group of commands 
introduced by DO) is to be executed if the comparison is true. 
THEN can be followed by another IF statement. 

ELSE specifies that a single command (or a group of commands 
introduced by DO) is to be executed if the comparison is false. 
ELSE can be followed by another IF statement. 

When an IF statement appears in a THEN or ELSE clause, it is 
called a nested IF statement. The maximum number of nested 
levels allowed is 10, starting with the first time you specify 
IF. 

Within nested IF statements, the innermost ELSE clause is 
matched to the innermost THEN clause, the next innermost ELSE 
clause is matched to the next innermost THEN clause, and so on. 
In other words, each ELSE clause is matched to the nearest 
preceding unmatched THEN clause. If there is an IF statement 
that does not require an ELSE clause, follow the THEN clause 
with a null ELSE clause, unless the nested structure does not 
requi re one. 

DO command can be specified with the THEN and ELSE clauses to 
indicate that the group of commands following are to be treated 
as a single unit, that is, to be executed as a result of a 
single IF statement. Commands following a DO must begin on a new 
line. The group of commands is terminated by END. 
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For command ? substitute the Device Support Facilities command 
that you want to process as a result of a single IF statement. 

END specifies the end of a group of Device Support Facilities 
commands initiated by the nearest unended DO. END must be on a 
line by i tself . 



NULL THEN AND ELSE CLAUSES 



SET STATEMENT 



When a THEN or ELSE clause is not followed by a continuation 
character or by a command in the same record, it results in no 
act i on . 

For example, to specify a null THEN clause when you want a 
Device Support Facilities command to execute if the IF statement 
is false, you specify THEN without a continuation character or 
Device Support Facilities command. On the next line, specify 
ELSE followed by a Device Support Facilities command. If you 
want to specify a null THEN clause, specify : 

IF . . . 
THEN 
ELSE . . . 

If you want to indicate a null ELSE clause, specify: 

IF . . . 
THEN . . . 
ELSE 



The SET statement sets a condition code. See "Condition Codes to 
Control Command Execution" earlier in this chapter for the 
explanation of condition codes. You can terminate all processing 
simply by setting MAXCC or LASTCC to 16. 



The syntax of the SET statement is : 



SET 



(LASTCC = condition code 
MAXCC = condition code} 



where? 

SET specifies that a condition-code value is to be set. If a SET 
statement is specified following a THEN or ELSE clause, and the 
clause is not executed because the comparison in the IF 
statement does not allow the clause to execute, the condition 
code specified with LASTCC or MAXCC is not set. 

LASTCC = condition code specifies that the condition code to be 
set is the condition code set by the immediately previous Device 
Support Facilities command. 

For condition code , substitute a decimal number, up to ten 
digits long, that is to be assigned to LASTCC. Condition codes 
greater than 16 will be reduced to 16. If the condition code 
assigned to LASTCC is a greater value' than the condition code 
assianed to MAXCC, MAXCC assumes the condition code assigned to 
LASTCC. 



undition code to be 
MAXCC does not affect 



MAXCC = condition code specifies that the con 
set is the maximum condition code. Setting MA 
the condition code for LASTCC. 

For condi t i on code , substitute a decimal number, up to ten 
digits long, that is to be assigned to MAXCC. Condition codes 
greater than 16 will be reduced to 16. 
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Continuation Lines 

Use continuation lines cautiously when specifying IF-THEN-ELSE 
statements, SET statements, comments, or blank records in the 
input stream. Blank records or records ending with comments must 
end with a continuation mark when you specify these types of 
records in the middle of a command or between the THEN and ELSE 
clauses of an IF statement. Always specify a continuation mark 
when records end with partial comments. (See "Line 
Continuations" on page 23 and "Comments" in Part 2.) 

You must be careful when you continue IF-THEN-ELSE statements so 
that you don't inadvertently specify a null THEN or ELSE clause. 
For information on this subject, see "Null THEN and ELSE 
Clauses" earlier in this chapter. 

EXAMPLES OF STATEMENTS TO CONTROL COMMAND EXECUTION 

The examples that follow show the use of the IF-THEN-ELSE 
statement sequence and the SET statement. 

IF-THEN-ELSE Statement: Example 1 

INIT DDNAME(VOLXYZ) VERIFYC VOLABC) 
IF LASTCC=0- 

THEN REFORMAT DDNAMEC V0L293) VOLID(SYXl) NOVERIFY 
ELSE REFORMAT DDNAMEC V0L123) V0LIDCSYX2) NOVERIFY 

SET Statement: Example 2 

SET LASTCC=8 
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PART 2. REFERENCE INFORMATION 



This part of the book is to be used as a reference when you code 
the Device Support Facilities commands. The commands are 
arranged in alphabetic order. The presentation of each command 
i ncludes: 

• A general description of the command and its use 

• A table summarizing the syntax of the command 

• An explanation of required and optional parameters 

• Examples 
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SYNTAX OF THE DEVICE SUPPORT FACILITIES COMMANDS 



The illustrations of command formats in this book use the 
folloNing conventions' 

Brackets ([]) indicate an optional field or parameter. 

Braces ({}) indicate that one of alternative items must be 
selected. 

Items separated by a vertical bar (|) represent alternative 
items. Only one item may be selected. 

An ellipsis (•••) indicates that multiple entries of the 
type immediately preceding the ellipsis are allowed. 

Boldface type indicates the exact characters to be entered. 
Such items must be entered as shown or in the abbreviated 
form allowed. 

Underscored uppercase type indicates a default option. If 
the parameter is omitted, the default value is assumed. 

Underscored lowercase or lowercase type indicates fields to 
be supplied by you. 

Parentheses, commas, slashes, spaces, and other punctuation 
must be entered as shown. 

Numeric parameters can be coded in two ways'- decimal or 
hexadecimal (X'n f ). This applies to any parameter that 
specifies a substitution of decimal numbers. 

Character string parameters can be coded either with or 
without enclosing them in single quotation marks. However, 
if delimiters such as commas, blanks, or parentheses appear 
within a character string, the string must be enclosed 
within single quotation marks. 

You can specify values with some keyword parameters. The value 
is entered within parentheses following the keyword parameter. A 
typical keyword with a value appears in this book as" 

VOL ID (serial) 

A value cannot contain commas, semicolons, blanks, parentheses, 
or slashes unless the entire value is enclosed within single 
quotation marks. (A single quotation mark in a field enclosed 
within quotation marks must be coded as two single quotation 
marks. ) 

Positional Parameters* In the explanations of commands within 
this book, the positional parameters are shown in lowercase 
underscored letters or lowercase letters. When a positional 
parameter consists of a list of items, you must enclose the list 
in parentheses. 



ABBREVIATING COMMANDS AND PARAMETERS 



Some of the commands and parameters can be abbreviated. 
Abbreviations for commands are listed just before the syntax of 
the command is shown. Abbreviations for parameters are shown 
with the heading "Abbreviations." The full form of the parameter 
is given first, then acceptable abbreviations. A vertical bar is 
used to separate the parameter and its abbreviations. 
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DELIMITERS 



When you issue a command, you must separate the command name 
from the first parameter by one or more blanks. You must 
separate parameters from each other by one or more blanks or a 
comma. Do not use a semicolon as a delimiter because any 
characters that follow a semicolon are ignored. 



LINE CONTINUATIONS 



COMMENTS 



TERMINATOR 



A command, IF statement, or comment can be entered using one or 
more lines. To continue a command or comment that requires more 
than one line, each line, except the last, must be terminated by 
a plus or minus sign in the last nonblank column at or before 
column 72. The minus sign causes leading blanks in the following 
line to be read as part of the command. The plus sign causes 
leading blanks in the following line to be ignored. 



You can add comments to any of the commands wherever a blank 
character can appear. To distinguish your comments from the 
commands, enter them within the comment delimiters /* and */ . A 
comment may be continued to the next line by using a line 
continuation character at the end of the line. 



The terminator indicates the end of the command. The terminator 
can be either an end-of-command condition (that is, no 
continuation mark) or a semicolon. If you use the semicolon as 
the terminator, the semicolon cannot be enclosed in quotation 
marks or embedded in a comment. Everything to the right of the 
semicolon is ignored. If there is information to the right of 
the semicolon that is continued to another record, all the 
information including the continued information is ignored. 

For example, if you code: 

REFORMAT UNITADDRESSC353) VOLIDC AA2314) ; VFYCBB2314, SMITH) - 
INIT . . . 
REFORMAT ... 

characters following the semicolon terminator are ignored. The 
continuation mark (minus sign) at the end of the second record 
causes the INIT command to be ignored also. The two REFORMAT 
commands are the only commands that are recognized. 



USING THE DEVICE SUPPORT FACILITIES COMMANDS 

A command consists of a command name followed by one or more 
operands or parameters. Hereafter, all operands described in 
this book are called parameters. They provide the specific 
information required for the command to perform the requested 
function. 

For example, some parameters associated with the INSPECT command 
indicate where the volume is mounted, the tracks that are to be 
inspected, and the verification of volume serial number and 
owner identification. 

The following is an example of this command? 

INSPECT DDNAME(VOLl) TRACKS( (4 ,6 ) , (4, 10 ) ) VERIFY(DSF123, SMITH) 
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where J 



• DDNAME specifies the DD statement that contains the 
description of the device. 

• TRACKS specifies that cylinder 4, tracks 6 and 10 are to be 
i nspected. 

• VERIFY specifies that volume serial number DSF123 and owner 
identification SMITH are to be verified before inspection 
cont i nues. 

Several of the parameters take default values if they are not 
specified when the command is issued. In the foregoing example, 
the following parameters were not specified, but are defaulted? 

CHECK(l) indicates that track surfaces are checked for 
recording errors. 

NORECLAIM indicates that no attempt is made to reclaim 
tracks that were previously flagged defective. 

PRESERVE indicates that existing data on the inspected 
tracks is saved and rewritten. 

MAP indicates that a volume map is printed after the command 
processes. 

ASSIGN indicates that alternate tracks are assigned for the 
specified tracks if they are shown to be defective as a 
result of surface checking. 

Note: When using an 80-column card format, the Device Support 
Facilities commands must be entered within columns 2 and 72. If 
the length of the command exceeds column 72, a continuation mark 
must be entered, and the command continued on the next line. 
When commands are entered at the console in a stand-alone 
environment, they can begin at the left margin and are also 
subject to the 72-column maximum. If conflicting keyword 
parameters are entered, execution of the command terminates. 



Conflicting keyword parameters are identified by a logical OR 
sign (|) representing alternative items. 
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ANALYZE 
ANALYZE: ANALYZING A VOLUME 



The ANALYZE command is for use with IBM direct-access storage 
devices (DASD) that have nonremovable storage media. ANALYZE 
examines the drive and the user's data to determine if there are 
errors. When ANALYZE detects an error, it prints a message to 
the operator and prints diagnostic information on the system's 
pri nter 




USING ANALYZE OUTPUT 



As part of an installation's operating procedures, ANALYZE 
output can assist in determining whether or not recovery 
procedures can or should be executed. However, the use of 
ANALYZE output by customer engineers or service representatives 
to isolate and to repair drive malfunctions should not replace 
the use of more detailed diagnostic tools and procedures 
available for that purpose. ANALYZE output in such instances 
should serve only as the initial reference material that shows 
the final problem symptom but does not specifically isolate the 
problem source. 

ANALYZE can determine whether the device to be tested is a 
nonremovable storage medium device or not. If the device to be 
tested is a 3350, ANALYZE also determines whether the logical 
volume is in native mode or one of the compatibility modes. If 
an attempt is made to execute ANALYZE against a device other 
than one with nonremovable storage media, ANALYZE issues an 
error message to the operator and processing terminates. 

Two basic tests are performed by ANALYZE — the drive test and the 
data verification test. The drive test is a general exercising 
of the storage device by issuing SEEK, READ, and WRITE commands. 
From the results of issuing these commands, ANALYZE determines 
the drive's ability to perform expected actions. 

Note: WRITE commands are only issued when the read/write head is 
positioned in the CE cylinder. If the drive test is completed 
successfully, the data verification test, which is optional, can 
then be performed. The data verification test reads (without 
data transfer across the channel to the CPU) to the maximum of 
every user data record on the logical volume. This determines 
whether the data can be read correctly — that is, without 
uncorrectable data check errors. (A logical volume is a portion 
of a physical volume that is viewed by the system as a volume.) 

In addition, a data verification option is provided that allows 
you to specify a portion of the volume for testing. For the 
supported count key data devices, one or more cylinders can be 
specified. For the supported fixed block devices, one or more 
blocks can be specified. You may also perform data verification 
for the entire volume. 

ANALYZE does not require exclusive control of the drive under 
test. Most of ANALYZE' s CCW chains (that is, its channel 
programs) do not hold the drive busy for longer than 0.5 second. 
However, if the operating system executes its error recovery 
procedures as a result of I/O errors detected during ANALYZE 
processing, the error recovery procedures may hold the drive 
busy for a longer period of time. 
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ANALYZE 



Assumptions 



ANALYZE data verification testing allows you to control the 
duration of each EXCP by specifying either SPEED or NOSPEED. 
This controls the duration of each EXCP as follows- 

• For the supported count key data devices, one EXCP per track 
is issued when NOSPEED is specified. When SPEED is 
specified, there is one EXCP issued for each cylinder. 

• For the supported fixed block devices, if NOSPEED is 
specified, one EXCP is issued (to read 32 and 248 blocks 
respectively). When SPEED is specified, one EXCP is issued 
to read 352 and 748 blocks respectively. 

ANALYZE supports the 3310 and 3370 devices in fixed block mode 
only. This mode is based on data transfers of 512-byte 
increments (blocks) for storing and retrieving data. 



When you run ANALYZE, the following conditions are assumed to 
exist: 

• The home address on each track in the user area is correct 
and readable. 

• The part of the CE cylinder that is written on by ANALYZE is 
free from defects. Also, the home address on each track in 
the CE cylinder is correct and readable. 

• All records on the logical volume's track in the user area 
have been written in a format consistent with the IBM 
standard record format. 

• The 3310 and 3370 data fields have been previously 
initialized (all data fields written). 



WHAT ANALYZE TESTS 



The Drive Test 



When an error occurs, the device (and its storage control unit) 
usually corrects the error and doesn't notify the operator or 
programmer that an error occurred. Under OS/VS, such errors are 
recorded by the operating system's erroi — recovery procedures 
(ERP). Data about those errors is available in the system's 
error log and printout, which is usually examined by the 
installation's system programmer and by the customer engineer or 
service representative who serves the installation. Under 
DOS/VSE, system error-recovery procedures are bypassed, and 
ANALYZE does its own sense analysis. Senses are printed by 
Device Support Facilities on SYSLST. 

Errors that are more persi stent and that cannot be corrected by 
the device's internal erroi — correction circuitry result in 
messages to the operator on the system console and on the output 
printer. Also, data errors may occur that cause a user to 
suspect a drive failure rather than a programming error. The 
three types of drive failures are drive errors, media errors 
(problems with the disk surface), and data format errors (the 
data is written in a format not consistent with the IBM standard 
format). ANALYZE performs two testing procedures to detect 
errors — the drive test and the data verification test. 



ANALYZE first determines the drive is fully operational by 
performing I/O operations that test the drive's functional 
capabilities. Each I/O operation, called a channel command word 
(CCW) chain, tests a specific function of the drive and logical 
volume. Tests are executed in order of increasing complexity. 
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ANALYZE 

Drive problems that can be detected during ANALYZE's initial 
tests are access arm positioning errors and the ability to read 
and write (in the CE cylinder). For the 3344 and 3350, the drive 
is also checked to ensure that it can detect an address mark, 
can switch read/write heads as a result of a multitrack command, 
can sense the disk's rotational position, and can detect and 
skip over defective areas on a track. 



The Data verification Test 



If ANALYZE completes all drive tests without error, the data 
verification test can be run. The ANALYZE data verification test 
determines the status of the drive's storage medium by reading 
(without data transfer to the processor) to the maximum of all 
data records on the volume. If a data check is detected during 
the test, both the address and the cylinder and head number or 
relative block number are noted in a diagnostic message on the 
printer. When a track or block is found to be defective, you can 
bypass the defect by assigning an alternate track or block to 
replace it. 

ANALYZE allows you options for the data verification tests : 

• You may specify data verification of the whole volume. 

• You may select a range of data to be verified either by 
cylinders or by blocks. 

• You may also select the SPEED or NOSPEED parameter or the 
data verification tests. 

SPEED specifies : 

Perform one EXCP per cylinder for the count key data 
devi ces. 

Perform one EXCP for the maximum number of blocks (352 
and 744 respectively) within the range specified for the 
3310 and 3370. 

NOSPEED specifies: 

Perform one EXCP per track for the count key data 
devi ces. 

For the 3310 and 3370 the number of blocks read by each 
EXCP is 32 and 248 respectively. 

When a block is found to be defective on a fixed block device, 
the system programmer can bypass the defective block by 
executing the DOS/VSE Assign Alternate Block (ALTBLK) utility 
program. 

Note : When errors other than data check occur during the data 
verification test, the errors may be identified by ANALYZE as 
data check errors. When you examine the sense information, 
however, you can determine whether the error is actually a data 
check or an intermittent or marginal drive error. 



ANALYZE^ Analysing a Volume 27 



ANALYZE 



SYNTAX 



Command 


Required Parameters 


ANALYZE 


UNITADDRESS(cuu) | 
DDNAME (dname) ! 
SYSNAHECsysxxx) 


Optional Parameters 


SCANINOSCAN 

LIMITS(scanlo,scanhi )|ALL 
SPEEDlNQSPEED 
MSS 



UNITA DDRESS iDDNAMElSYSNAME: IDENTIFYING THE DEVICE ON UHICH THE VOLUME IS 

MOUNTED 

Explanation: UNITADDRESS ( cuu ) I DDNAMEC dname ) 1 S YSNAME( sysxxx ) are 

required parameters identifying the volume that is to be 
analyzed. 

UNITADDRESS 

Required when analyzing a volume that is mounted offline or 
when analyzing a volume in a stand-alone environment. 

For cuu > specify the address in hexadecimal of the channel 
and unit on which the volume is mounted. 

Note : The device must be on a channel that is online. If 
the device i s on a channel that is offline, the program may 
enter a nontermi nat i ng wait state. 

DDNAME 

Required when analyzing a volume that is mounted online. 
The device on which the volume is mounted must be online. 

For dname, specify the OS/VS JCL statement that identifies 
the device on which the volume is mounted. 

SYSNAME 

Required when analyzing a volume in the DOS/VSE 
environment. For sysxxx , specify the SYSNAME in the ASSGN 
system control statement. 

Abbreviations: 

UNITADDRESS | UNITADDR | UNIT 
DDNAMEl DNAME 

Defaults: None 

Restrictions: The DDNAME or SYSNAME parameter cannot be 
specified when analyzing a volume in a stand-alone environment. 



SCANiNOSCAN: RUN DATA VERIFICATION TESTS 

Explanation: SCANiNOSCAN are optional parameters specifying 
whether the data verification tests are to be run after 
successful completion of the drive tests. 



SCAN 



Indicates that you want the data verification tests to be 
run after successful completion of the drive tests. 
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NOSCAN 

Indicates that you do not want the data verification tests 
to be run after successful completion of the drive tests. 

Abbreviations: 

SCAN I SCN 
NOSCAN|NOSCN|NSCAN|NSCN 

Default: NOSCAN 

Restrictions: None. 



LIMITS: SPECIFYING THE AREA OF DATA VERIFICATION 

Explanation: LIMITS ( scanlo , scanhi ) I ALL are optional parameters 
to specify the area of the disk where data verification is to be 
performed. For fixed block devices, you specify the range of 
blocks to be read during the data verification tests. For count 
key data devices* you specify the range of cylinders that are to 
be read during the data verification tests. 

LIMITS( scanlo, scanhi ) 

scanlo specifies, for fixed block devices, the relative 
block number for the start of the data verification tests. 
For count key data devices, scanlo specifies the relative 
cylinder number for the start of the data verification 
tests, scanlo can be expressed in decimal (n) or 
hexadecimal (X'n') form. 

scanhi specifies, for fixed block devices, the relative 
block number of the last block of the data verification 
tests. For count key data devices, scanhi specifies the 
relative cylinder number of the last cylinder of the data 
verification tests, scanhi can be expressed in decimal (n) 
or hexadecimal (X'n') form. 

Note: For fixed block devices, a rounding algorithm is used 
to calculate, depending on whether the SPEED or NOSPEED 
option is chosen, the optimum number of blocks to be read 
for each EXCP. (This optimum number of blocks takes 
advantage of certain device characteristics to aid in 
further isolation of problems.) For example, if you code 
SCAN LIMITSCOylO) on the control statement and the device 
is a 3310, the channel program would be built to read 32 
blocks starting at relative block 0; and if SPEED were 
coded, the channel program would be built to read 352 
blocks. 

Also, the numbers scanlo and scanhi must be equal or in 
ascending order, and they must fall within the device 
address limits: low to high relat i ve cylinder number or low 
to high relat i ve block number. Incorrect specification will 
result in an error message and cause execution of the 
command to terminate. 



ALL 



An optional parameter which specifies that all blocks or 
all cylinders are to be read during the data verification 
tests. 



Abbreviations: 

LIMITS|LIMIT|LIMS|LIM 

Default: ALL 

Restrictions: The LIMITS parameter applies only when the SCAN 
parameter has been specified. 



ANALYZE: Analyzing a Volume 29 



ANALYZE 

SPEED (N OSPEED: SPECIFY DATA VERIFICATION TESTS 

Explanation^ SPEED 1 NOSPEED are optional parameters which specify 
how much is read by each EXCP for the data verification tests. 

SPEED 

For the 3310 and 3370, this parameter specifies that the 
maximum number of blocks is read for each EXCP (352 and 744 
respectively). For count key data devices, one cylinder is 
read at a time. 

NOSPEED 

For the 3310 and 3370, NOSPEED specifies the number of 

blocks for each EXCP is 32 and 248 respectively. For count 

key data devices, one track is read at a time. 

Abbreviations* 

NOSPEEDlNSPEED. 

Defaults: NOSPEED. 

Restrictions' You should not specify SPEED when you sire running 
under VM/370, as this degrades the performance of other VM/370 
users. 



MSS: ANALYZING AN MSS STAGING VOLUME 

Explanation* MSS is an optional parameter to be specified only 
when ANALYZE is executed against an emulated 3330-11 MSS staging 
volume that resides on a 3350 device. 

By specifying this parameter* you are allowed to specify 
cylinder 808 (instead of cylinder 807) as the upper limit for 
the data scan portion of the command (see the LIMITS parameter). 

Abbreviations* None. 

Defaults: None. 

Restrictions: If the MSS parameter is specified without the 
LIMITS parameter, the data scan, if requested, will include 
cylinder 808. If MSS is not specified, ANALYZE will treat the 
volume as a nonstaging volume and will allow only cylinder 807 
as the data scan upper limit. 



EXAMPLES OF THE ANALYZE COMMAND 

The following examples show different ways to use the ANALYZE 

command. 

Note: Any values specified here are examples only and should not 
be interpreted as the values for your system. 

ANALYZING A VOLUME IN A STAND-ALONE ENVIRONMENT: EXAMPLE 1 

In this example, the 3310 Direct Access Storage drive tests are 
performed. 

ANALYZE UNITADDRESS(141) 

Using keyword abbreviations, you could have specified: 

ANALYZE UNIT(141) 
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ANALYZING A VOLUME IN A STAND-ALONE ENVIRONMENT: EXAMPLE 2 

In this example, the 3310 Direct Access Storage drive tests are 
performed and are followed by the data verification tests for 
the entire 3310 volume. ALL is the default. 

ANALYZE UNITADDRESS(141) SCAN 



ANALYZING A VOLUME IN A STAND-ALONE ENVIRONMENT: EXAMPLE 3 

In this example, the 3370 Direct Access Storage drive tests are 
performed, followed by partial data verification tests 
beginning at relative block number 25 and ending at relative 
block number 50. Abbreviations have been used. 

ANALYZE UNIK141) LIM5(25,50) SCN 

this fixed block architecture device, the actual data 
ion would have resulted in two EXCPs being issued. The 
Id have read relative blocks through 31; the second 
e read relative blocks 32 through 63. The rounding 
, taking the default of NOSPEED, first verified that 
s were within the device limits, and then rounded up 
limit to 63 and then rounded down the low limit to 0, 

in two EXCPs, each reading 32 blocks. (If SPEED had 
ified, rounding would have resulted in one EXCP to read 
s.) 



Note: 
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ANALYZING A VOLUME IN A STAND-ALONE ENVIRONMENT: EXAMPLE 4 

In this example, the 3350 Direct Access Storage drive tests are 
performed, followed by partial data verification tests beginning 
at relative cylinder 6 and ending at relative cylinder 9. 

ANALYZE UNITADDRESSC351) LIMITS(6,9) SCAN 

ANALYZING A VOLUME IN AN OS/VS ENVIRONMENT (ONLINE): EXAMPLE 5 

In this example, drive tests are performed on two volumes 
(designated as VOLUMEG and V0LUME2). Specification of the SCAN 
parameter indicates that data verification tests are to be run 
after successful completion of the drive tests. 



//EXAMPLE5 JOB 



// 


EXEC 


//VOLUMEG 


DD 


//V0LUME2 


DD 


//SYSPRINT 


DD 


//SYSIN 


DD 



PGM=ICKDSF 

UNIT =3330, DISP=0LD,V0L=SER=PAY345 

UNIT =3330, DISP=OLD,VOL=SER=PAY320 

SYS0UT=A 

x 



ANALYZE DDNAME(VOLUMEG) 
ANALYZE DDNAME(V0LUME2) SCAN - 
LIMITS(2,5) 
/x 



ANALYZING A VOLUME IN A DOS/VSE ENVIRONMENT: EXAMPLE 6 



In this example, drive tests are performed on the volume SYS001 
Specification of the NOSCAN parameter indicates that data 
verification tests are not to be performed. 



// 
// 
// 

/x 
/I 



JOB jobname 

ASSGN SYS001,150 

EXEC ICKDSF,SIZE=256K 

ANALYZE SYSNAME(SYSOOl) 



NOSCAN 
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ANALYZING AN MSS VOLUME IN AN OS/VS ENVIRONMENT (OFFLINE): EXAMPLE 7 

In this example, drive tests are performed on an MSS volume 
(3330-11 emulated on a 3350) that is mounted on a cuu address of 
164. 

//Example7 JOB 
// EXEC PGM=ICKDSF 
//SYSPRINT DD SYS0UT=A 
//SYSIN DD x 

ANALYZE UNITU64) MSS 
/x 



DIAGNOSTIC MESSAGES 



ANALYZE prints diagnostic messages on the system printer or on 
the system console. They can be used by a programmer (and by the 
customer engineer or service representative) to determine more 
precisely the kind of problem that is detected by ANALYZE. 

A diagnostic message names the test in which the failure 
occurred, and is followed by information appropriate to 

describing the erroi a display of the failing CCW, the CSW at 

the time of failure, and the sense bytes, as follows : 

SNS TEST 

CSW = 008050 0E000000 CCW = 041F8D78 20000018 

SENSE = 10000800 10008910 180B60B5 400E188F OE010003 

00001440 

In the above example, a channel command word (CCW) issued during 
the SNS test failed. In the CSW, the channel end, device end, 
and unit check indicators are on. For more details on CCW, CSW, 
and sense byte interpretation, see the appropriate direct-access 
storage reference manual (see the list in the "Preface"). 

Diagnostic messages are issued during the drive tests and data 
verification tests if an error is detected. These messages and 
their meanings are shown in Figure 3 on page 33 and Figure 4 on 
page 34. 

Most of the diagnostic messages are useful only to the customer 
engineer or to the service representative. Four of the 
diagnostic messages, however, are useful to the programmer who 
analyzes the output from ANALYZE. The four messages are 
described below so that you can understand the conditions under 
which each is issued. Your installation's recovery procedures 
may correct the problems indicated by these messages, so that 
you do not have to call a customer engineer or service 
representative to correct them. 

• WRT WRITE INHIBIT SWITCH ON 

This condition is detected when the WRT test attempts to 
write a record and fails because the "R/W or READ" switch on 
the drive's operator panel is in the "READ" position. 

This message provides sense information that verifies 
console message ICK414I. The operator's response to message 
ICK414I usually corrects the condition. The operator should 
rerun ANALYZE if the testing of the drive's writing 
capabilities is desired. 
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MOVABLE HEAD ERROR TABLE 
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Figure 3. The Movable Head Error Table 



DATAVER DATA CHECKS EXCEEDED THRESHOLD 

A data check is a read/write error that the device detects* 
and is indicated in the sense bytes. When the number of 
tracks with data checks for a logical volume exceeds the 
number of alternate tracks for the volume, the data 
verification test prints this message and terminates. The 
threshold for each type of logical volume is : 

IBM 3344 logical volume — 24 data checks 

IBM 3350 (native mode) volume — 150 data checks 

IBM 3350 (3330-1 mode) logical volume — 133 data checks 

IBM 3350 (3330-11 mode) logical volume — 133 data checks 

IBM 3375 (native mode) volume — 15 data checks 

IBM 3380 (native mode) volume — 15 data checks 

For fixed block architecture device support, this message 
has a different meaning. The 3310 and 3370 each have a very 
high number of alternate blocks that can be assigned by the 
user to bypass data errors in prime blocks. Because the 
number is very high, ANALYZE execution is terminated after 
504 data checks have been logged on the system printer. 
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HEAD NUMBER DATA CHECK 
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FIXED HEAD ERROR TABLE 
SEEK VERIFY HEAD NUMBER 



30 
31 
32 
33 
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52 
53 
54 
55 
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57 
58 
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DATA CHECK SEEK VERIFY 
CHECK 






Figure 4. The Fixed Head Error Table 



DATAVER DATA CHECK ADDR 

This error is detected when the data verification test 
detects a data check. For the 3344 and 3350 the logical 
volume's cylinder, CC, and head, HH, are printed to indicate 
the track on which the data check occurred. These are 
hexadecimal values that indicate the logical, rather than 
physical, address on the logical volume. For the 3310 and 
3370, ADDR is the failing relative block number for the 
device. Each data check detected by the data verification 
test is described with this message. 

This message may also be printed when a drive error that 
would normally have been detected during the drive tests 
occurs during the data verification test. The condition that 
caused the drive error is usually intermittent or marginal, 
and was not detected during the drive tests. You can examine 
the sense bytes to determine whether a data check or another 
type of error occurred. 

DATAVER DATA FORMAT UNACCEPTABLE ON CYL xx 

This error is detected during the data verification test 
when one of the 
data device 1 



following conditions occurs on a count key 



The test determines that the data on the identified 
cylinder is written in a format other than the IBM 
standard format. This is the usual cause of the message 
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A drive error (such as dropping ready) occurred during 
the test. The condition that caused the drive error is 
usually intermittent or marginal, and was not detected 
during the drive tests. 

When the volume under test is also accessed by another 
program, the other program erased an end-of-data record 
after it had been read by the data verification test and 
before it had been read again by the test. This is a 
possible, though unlikely, situation. 

The volume's logical cylinder address, a hexadecimal value, 
is printed with the message. To determine more accurately 
the cause of the message, you can examine the sense 
information and the CSW (if it is printed with the message). 
If an intermittent drive error occurred, the sense 
information can be used to analyze it. 

In addition to the diagnostic messages, ANALYZE produces 
tables that summarize errors associated with the read/write 
circuitry that occurred during the drive tests* the movable 
head error table (shown in Figure 3 on page 33), and the 
fixed head in Figure 4 on page 34. 

Note* The fixed head error table may be printed even though the 
drive under test does not include the fixed-head feature. In 
that case, the table applies to movable heads 00 through 29. 



DRIVE TEST MESSAGES 



During the drive test, diagnostic messages are issued on the 
system printer for each error detected during execution of a 
channel program. If a channel program has not completed 
successfully, an appropriate diagnostic message is issued. 

A diagnostic message identifies by name the test in which the 
failure occurred, and is followed by information appropriate to 
describing the error, such as a display of the failing CCU, the 
CSW at the time of failure, and the sense bytes. Figure 5 shows 
the diagnostic messages and their meanings of each message. 



Diagnostic Message Issued 


Meaning 


FIXED BLOCK CALIBRATION 
SEEK TEST*. BCALSK 


An error is detected during an 
attempt to move the access arm 
from block 244 to a specified 
location and back again to 
read. 


FIXED BLOCK HEAD SEEK 
TEST: BHDSK 


An error is detected during an 
attempt to write multiple 
blocks and seek to the next 
sequential track. (3310 only) 


FIXED BLOCK INCREMENTAL 
SEEK TEST: BINCSK 


An error is detected during an 
attempt to switch heads ran- 
domly to read. 


FIXED BLOCK SERVO SEEK 
TEST: BSRVOSK 


An error is detected during an 
attempt to write and read back 
•block 244 of the CE area. 


FIXED BLOCK DATA COMPARE 
FAILED: BWRCE 


An error is detected when the 
record read did not compare 
equally with the same record 
previously written. 



Figure 5 (Part 1 of 3). Drive Test Diagnostic Messages 
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Diagnostic Message Issued 


Meaning 


FIXED BLOCK READ PREFOR- 
MATTED BLOCK TEST:BWRNFPS 


An error is detected during an 
attempt to read block 296 of 
the CE area (3370 only) 


FIXED BLOCK WRITE PRESE- 
LECTED BLOCKS TEST: 
BWRNFP 


An error is detected during an 
attempt to write multiple 
blocks in the CE area. (3370 
only) 


CLEANUP TEST: CLEANUP OF 
C. E. CYLINDER TRACK 
FAILED (see note) 


An error is detected when ANA- 
LYZE has completed its test 
and an error occurs during the 
cleanup of track 1 on the CE 
cylinder. 


RDMT DATA COMPARE TEST: 
WRONG RECORD READ (see 
note) 


An error is detected when a 
drive error caused the wrong 
record to be read. 


RDMT TEST: MULTI-TRACK 
READ IN C. E. CYLINDER 
FAILED (see note) 


An error is detected when ANA- 
LYZE attempts to read records 
on the CE cylinder. 


RECAL TEST: RECALIBRATE 
TO CYL HEAD FAILS 
(see note) 


An error is detected when ANA- 
LYZE attempts to recalibrate* 
the access arm to cylinder 0, 
head and fails. 


RHA HA INCORRECT: HOME 
ADDRESS DATA READ IS 
INCORRECT 


An error i s detected when ANA- 
LYZE reads a home address oth- 
er than the one expected. 


RHA TEST: READ HOME 
ADDRESS ON CE. CYLINDERS 
FAILED(see note) 


An error is detected when ANA- 
LYZE attempts to read the CE 
cylinder's home address and 
fai Is. 


RHAFH TEST: READ HOME 
ADDRESS UNDER FIXED HEADS 
FAILED (see note) 


An error i s detected when ANA- 
LYZE attempts to read all the 
home addresses under the fixed 
heads and fai Is. 


RHAMH TEST: READ HOME 
ADDRESS UNDER MOVEABLE 
HEADS FAILED (see note) 


An error is detected when ANA- 
LYZE attempts to read home 
addresses under all the mova- 
ble heads and fails. 


RPS ERROR: READ SECTOR OR 
SET SECTOR FAILED (see 
note) 


An error i s detected when ANA- 
LYZE attempts to read sector 
or to set sector and fails. 


SKINCR TEST: INCREMENTAL 
MOVEMENT OF ACCESS ARM 
FAILED (see note) 


An error i s detected when ANA- 
LYZE attempts to move the 
access arm incrementally and 
fai Is. 


SKMAX TEST: SEEK FROM 
CYLINDER TO MAXIMUM 
CYLINDER FAILED (see 
note) 


An error is detected when ANA- 
LYZE attempts to move the 
access arm from cylinder to 
the maximum cylinder address 
and fai Is. 



Figure 5 (Part 2 of 3). Drive Test Diagnostic Messages 
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Diagnostic Message Issued 


Meaning 


SKRAN TEST: RANDOM CYLIN- 
DER ACCESS FAILED (see 
note) 


An error is detected when ANA- 
LYZE attempts to move the 
access arm "randomly" from one 
cylinder address to another 
and fai Is . 


SNS TEST: ERROR IN SENSE 
CCU (see note) 


An error is detected when ANA- 
LYZE attempts to obtain sense 
information and fails. 


WRT TEST: WRITE RECORDS 
RO and Rl ON C.E. CYLIN- 
DER FAILED (see note) 


An error i s detected when ANA- 
LYZE attempts to write records 
and 1 on the CE cylinder and 
fails. 


x*x WRITE INHIBIT SWITCH 
ON 


An error is detected when ANA- 
LYZE attempts to wri te a 
record and fails because the 
"R/W" or "READ" switch is in 
the "READ" position, or the 
"READ/WRITE" switch position 
i s def ect i ve. 


WRTPAD READ WRONG RECORD 


An error is detected when ANA- 
LYZE attempts to write a 
record using the write count, 
key, and data command, and 
read it back. The record read 
back (which should have been 
overwritten with zeros) was 
not as expected. 


WRTPAD TEST: WRITE COUNT, 
KEY, DATA FAILED (see 
note) 


An error is detected when ANA- 
LYZE attempts to write a 
record using the write count, 
key, and data command and 
fai Is. 



Figure 5 (Part 3 of 3). Drive Test Diagnostic Messages 

Note to Figure 5 on page 35 

The diagnostic message is followed by: 

CSW = hhhhhh hhhhhhhh CCW = hhhhhhhh hhhhhhhh SENSE = hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh where CSW = i s 
followed by 7 bytes of the failing CSW in hexadecimal digits, 
CCW = is followed by 8 bytes of the failing CCW in hexadecimal 
digits, and SENSE = is followed by 24 bytes of the sense 
information displayed in hexadecimal digits. For detailed 
information on the sense information, see the reference manuals 
listed in the Preface. 



MOVABLE AND FIXED HEAD ERROR TABLES 



In addition to the diagnostic messages, if errors associated 
with the read/write circuitry occurred during the drive test, 
ANALYZE produces two tables to summarize the errors; a movable 
head error table and a fixed head error table. These tables are 
printed on the system printer after all tests are completed. 
Figure 3 on page 33 shows the format of the movable head error 
table. The physical heads or tracks are listed in the first 
column on the left. A character 'X' is placed in the column 
corresponding to the type of error detected for a particular 
head. Figure A on page 34 shows the format of the fixed head 
error table. The first column of the left group and the first 
column of the right group list the physical head or tracks. A 
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character T X' is placed in the column corresponding to the type 
of error detected for a particular head. 

The fixed head error table could be printed for a 3350 in native 
or compatibility mode even if the fixed head feature were not 
specified. This may happen if an intermittent error occurred on 
the movable heads during the fixed head test. If this occurs* 
see the conversion table in Figure 6 to determine which physical 
movable head number corresponds with the fixed head number in 
the fixed head error table. 
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DATA VERIFICATION TEST MESSAGES 



During the data verification test, diagnostic messages may be 
issued on the system printer if an error is detected. See 
Figure 7 for a list of messages that may be issued and their 
meani ngs. 



Diagnostic Message Issued 


Meaning 


DATAVER DATA CHECK ADDR = 
hhhh hhhh (see Notes 1 
and 2) 


A data check was detected dui — 
ing the data verification 
test. The probable cause was a 
media problem but a drive 
error may have occurred. The 
condition that caused the 
drive error is intermittent or 
marginal and was not detected 
during the drive test. 


DATAVER DATA CHECKS 
EXCEEDED THRESHOLD 


For CKD devices, the number of 
tracks with data checks for 
the device has exceeded the 
number of alternate tracks on 
the volume. For FBA devices, 
the number of data checks 
exceeded the arbitrary limit 
of 504. 


DATAVER DATA FORMAT UNACC 
EPTABLE ON CYL hhhh hhhh 
(See Notes 1 and 2) 


For CKD devices, data on the 
cylinder is written in a foi — 
mat other than the IBM stand- 
ard format, or an intermittent 
drive error occurred during 
the data verification test, or 
the volume under test was 
accessed by another program 
and the other program erased 
an EOD record after it has 
been read by the data verifi- 
cation test and before it has 
been reread by the test. 


DATAVER TEST: ERROR DUR- 
ING DATA VERIFICATION 
(see Note 2) 


A drive error was detected 
during the data verification 
test. 


DATAVER PERMANENT ERROR 
ADDR = hhhh hhhh (see 
Notes 1 and 2) 


A drive error was detected 
during the data verification 
test. 


DATAVER TEMPORARY ERROR 
ADDR = hhhh hhhh (see 
Notes 1 and 2) 


A drive error was detected 
during the data verification 
test. 



Figure 7. Data Verification Test Diagnostic Messages 
Notes to Figure 7: 

1. The logical volume's cylinder and head are represented by 
hhhh hhhh. This value is in hexadecimal. 

2. The diagnostic message is followed by : 

CSW = hhhhhh hhhhhhhh CCW = hhhhhhhh hhhhhhhh SENSE = 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh where 
CSW = is followed by 7 bytes of the failing CSW in 
hexadecimal digits, CCW is followed by 8 bytes of the 
failing CCW in hexadecimal digits, and SENSE = is followed 
by 24 bytes of the sense information received in hexadecimal 
di gits. 
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BUILDIX: BUILDING A VTOC INDEX 



Direct access volumes in the 05/VS environment may optionally be 
changed from the OS format VTOC (OSVTOC) to the indexed format 
VTOC (IXVTOC) by invoking the BUILDIX command. BUILDIX will 
build a VTOC index data set and prepare the VTOC to show that 
the volume is in IXVTOC format. BUILDIX will also change a 
volume in IXVTOC format to OSVTOC format. 

To build an index data set on a volume> the BUILDIX command 
requires that the host system contain indexed VTOC programming 
support. Execution of the command will terminate without action 
if this support is not present. 



Not©: The BUILDIX command is 
and 0S/VS2 MVS environments. 



a valid command only in the 0S/VS1 



DEVICES SUPPORTED BY THE BUILDIX COMMAND 



All real devices supported by the host OS/VS operating system 
are supported by the BUILDIX command with the exception of the 
2314 direct access storage device. MSS virtual volumes (3330V) 
are also supported by the BUILDIX command. VM/370 users who IPL 
an indexed VTOC supporting operating system can use BUILDIX to 
format minidisks and attached volumes by submitting batch jobs 
to their virtual machine. 

Volumes containing split cylinder extents are not supported by 
the BUILDIX command. DOS volumes will be converted to OSVTOC 
format or to IXVTOC format* according to the parameters 
speci f i ed. 



SYNTAX 



Command 


Required Parameters 


BUILDIX 


DDNAME(dname) 
IXVTOC | OSVTOC 


Optional Parameters 


PURGE INOPURGE 



DDNAME: IDENTIFYING THE DEVICE ON HHICH THE VOLUME IS MOUNTED 

Explanation: DDNAME( dname ) must be specified to identify the 
volume whose VTOC is to be changed. 

DDNAME 

Required when a volume is mounted online. The device on 
which the volume is mounted must be online and the volume 
mounted as PRIVATE with DISP=0LD specified. 

For dname , specify the OS/VS JCL DD statement that 
identifies the device on which the volume is mounted. 
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Abbreviations: 

DDNAMElDNAME 
Restrictions: None. 
Defaults: None. 

IXVTOC iOSVTOC: IDENTIFYING THE BUILDIX FUNCTION TO BE EXECUTED 

Explanation: IXVTOC or OSVTOC must be specified to identify the 
BUILDIX function to be executed. 

IXVTOC 

Causes an OS/VS format VTOC to be changed to the indexed 

format . 

OSVTOC 

Causes an indexed VTOC to be changed to an OS/VS format. 

Abbreviations: 

IXVTOCjIX 
0SVT0CI0S 

Defaults: None. 

Restrictions: IXVTOC may only be specified if indexed VTOC 
programming support is part of the host system. Command 
execution will terminate with no action taken* if this support 
i s not avai lable. 

PURGE iNOPURGEt SPECIFYING DISPOSITION OF THE INDEX DATA SET 

Explanation: PURGE 1 NOPURGE are optional parameters describing 
the final disposition of the index data set when changing an 
indexed VTOC to an OS/VS format VTOC. 

PURGE 

Causes deletion of the index. 

NOPURGE 

Causes the index to be left on the volume. 

Abbreviations: 

PURGElPRG 
NOPURGElNOPRG 

Default: NOPURGE. 

Restrictions This parameter is valid only when changing from an 
indexed VTOC to an OS/VS VTOC. If specified with the parameter 
IXVTOC, the option is ignored. 



BUILDIX: OSVTOC TO IXVTOC 

If changing to an indexed VTOC, before invocation of BUILDIX you 
must preallocate the index data set in a separate job or job 
step; or you must provide a DD card describing the index data 
set in the same job step so that the scheduler will cause 
allocation of the index before command execution begins. 
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You must ensure that the name of the index data set begins with 
the characters "SYS1 . VTOCIX. " and must provide a unique 
third-level qualifier for each index data set in your 
installation. The recommended convention is 

"SYS1 . VTOCIX. volser, " which ensures that all online volumes have 
uniquely identified index data set names. This prohibits ENQ 
lockouts on all other volumes needing IXVTOC service functions 
to be performed. The name "SYS1 . VTOCIX. " is a reserved name in 
systems supporting the indexed VTOC, and only one data set per 
volume may begin with this prefix. 

Space for the index must be reserved in one continuous extent. 
This can be accomplished by allocating the index by absolute 
track or by specifying the CONTIG subparameter for all other 
requests. The amount of space to reserve for the index is 
device-dependents as well as dependent upon the size (in tracks) 
of the VTOC. A reference table to aid in determining how much 
space to reserve for the index is found in Appendix E. 



BUILDIX: IXVTOC TO OSVTOC 



This function will allow you to change an IXVTOC to an OSVTOC. 

You are provided an option to leave the index allocated 
(NOPURGE) or to delete it (PURGE). The option to leave it 
ensures that, if the volume should be changed again to the 
IXVTOC format, no calculation as to si2e and optimum location 
would be necessary. This convenience is realised when an IXVTOC 
volume is temporarily transported to a location that does not 
have programming support for the indexed VTOC and is then 
returned to a location having such support. 

The procedure to follow when transporting IXVTOC volumes to 
nonindexed VTOC systems is to prepare the volumes prior to their 
removal from the indexed VTOC system by executing BUILDIX and 
specifying the OSVTOC parameter. Upon return of a volume, 
BUILDIX is again executed, if desired, to rebuild the index. 

Care must be exercised if IXVTOC volumes are to be temporarily 
transported to nonindexed VTOC systems. If the volumes are not 
changed to OSVTOC format prior to being transported, serious 
errors may result when the volumes are returned to the indexed 
VTOC system. DADSM functions performed by the nonindexed VTOC 
system on the VTOC do not always force reconstruction of the 
VTOC to OSVTOC format. VTOC changes not causing reconstruction 
of the VTOC are not recorded in the index and, in effect, 
invalidate the index. 



EXAMPLES OF HAYS TO CODE THE BUILDIX COMMAND 

The following examples illustrate ways in which the BUILDIX 
command might be coded in a variety of situations. 

The examples show the job control language statements you will 
need when invoking the BUILDIX command. 

Note that the content of the data definition statement varies 
according to the function to be executed. The examples show 
various specifications of the statement. 
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CHANGING AN IXVTOC TO AN OSVTOC: EXAMPLE 1 

In the following example, a 3330 volume having the volume 
identification VL3330 is to be changed to OSVTOC format. The DD 
statement simply identifies the volume. 

//jobname JOB . . . 

//stepname EXEC PGM=ICKDSF 

//SYSPRINT DD SYS0UT=A 

//DDCARD DD UNIT=(3330 , , DEFER) , VOL=(PRIVATE, SER=VL3330) , 

// DISP=0LD 

//SYSIN DD X 

BUILDIX DDNAME(DDCARD) OS NOPURGE 
/* 

• UNIT=(3330 ,, DEFER) specifies that mounting of the volume on 
the 3330 device type is to to be deferred to prevent other 
users from sharing the volume. 

• VOL=(PRIVATE,SER=VL3330) identifies the volume and specifies 
a private mounting to prevent use of the volume for 
temporary data sets. 

• DISP=0LD specifies that allocation routines will check the 
mount status of VL3330 and issue appropriate messages to the 
operator. 

• Specification of NOPURGE in the BUILDIX command statement 
indicates that the index is to be left allocated. If NOPURGE 
were not specified, the command statement would have the 
same effect, since NOPURGE is the default. Specification of 
PURGE, as in the following command statement, would cause 
the index to be deleted. 

BUILDIX DDNAME(DDCARD) OSVTOC PURGE 

Note : Whether the index is purged or left allocated is 
controlled by command parameters. Disposition of the index 
data set must not be specified in the DD statement. 

BUILDING A VTOC INDEX ON A VOLUME WITHOUT AN INDEX ALLOCATED: EXAMPLE 2 

This option requires additional parameters on the DD statement 
to cause allocation of the index. The statement must contain 
data set information for the index. 

//jobname JOB . . . 

//stepname EXEC PGM=ICKDSF 

//SYSPRINT DD SYSOUT=A 

//VOLDD DD UNIT=(3330,, DEFER), VOL=(PRIVATE,SER=VL3330), 

// DSN=SYS1.VTOCIX.VL3330,DISP=( NEW, KEEP), 

// SPACE=(ABSTR,(10,D) 

//SYSIN DD x 

BUILDIX DDNAME(VOLDD) IXVTOC 
/* 

• DSN=SYS1.VTOCIX.VL3330 specifies the name of the index data 
set. The third-level qualifier, VL3330 (the volume serial), 
follows the recommended convention for naming the index. 

• DISP=(NEW,KEEP) directs the system allocation routines to 
allocate the data set prior to execution of Device Support 
Facilities commmands and to retain it upon termination of 
the task. 

• SPACE=(ABSTR, (10,1) ) directs the allocation routines to 
allocate a ten-track index starting at track one. ABSTR is 
specified in the space request to ensure that the index 
space is a single continuous extent and is in the location 
desired by the user. If location is not a primary concern, 
space can be reserved by specifying SPACE=(TRK, 10 , ,C0NTIG) . 
This causes ten contiguous tracks to be reserved at some 
location. 
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BUILDING A VTOC INDEX ON A VOLUME WITH AN INDEX ALLOCATED: EXAMPLE 3 

In this example, the volume identified as VL3330 was changed to 
an 05/VS format at some time, either by the user or by a system 
routine that disabled the index and changed the VTOC to OSVTOC 
format. The index data set was left allocated on the volume. The 
DD statement required to change again to an IXVTOC is shown. 

//jobname JOB ... 

//stepname EXEC PGM=ICKDSF 

//SYSPRINT DD SYS0UT=A 

//VOLDD DD UNIT=(3330,, DEFER), VOL=(PRIVATE, SER=VL3330) , 

// DSN=SYS1.VTOCIX.VL3330,DISP=OID 

//SYSIN DD * 

BUILDIX DNAME(VOLDD) IX 
/* 

• DISP=0LD specifies that the data set exists. 
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INIT: INITIALIZING A VOLUME 



A direct-access storage volume must be initialized before an 
operating system can use it. The INIT command can initialize 
count key data volumes at minimal* medial, and maximal levels by 
specifying parameters that control the level of initialization. 
These several levels of initialization ar& described in the 
sections that follow. 



INITIALIZING A VOLUME AT THE MINIMAL LEVEL 



A volume is initialized at the minimal level when both the 
NOVALIDATE and NOCHECK parameters are specified. 

Minimal initialization creates the contents of cylinder 0, track 
by: 

• Writing IPL bootstrap records as records 1 and 2 

• Writing a volume label as record 3 

and reserves tracks for the VTOC at the location specified by 
the user and for the number of tracks specified. If no location 
is specified, tracks are reserved at the default location. 

If the INDEX parameter of the INIT command is specified, a 
format-1 DSCB is built in the VTOC with the default data set 
name of SYS1 . VTOCIX. volser . If the volser begins with a numeric 
character, the default data set name will be SYS1 . VTOCIX. Vccccc. 
For example, if the volser is 333001 the default data set name 
written in the format-1 DSCB is SYS1 . VTOCIX . V33001 . 

Alternate tracks are checked for defective-track flags. If the 
defective-track flag is ON for an alternate track (indicating 
that it is, itself, defective), and if the associated primary 
track is still flagged defective, a nondefective alternate track 
is assigned to the primary track. 

Primary track surfaces are not checked. Primary tracks that ar& 
associated with alternate tracks are assigned nondefective 
alternate tracks. If a primary track is incorrectly associated 
with an alternate track, or is flagged defective but not 
associated with an alternate track, an error message is issued. 



INITIALIZING A VOLUME AT THE MEDIAL LEVEL 



A volume is initialized at the medial level 
VALIDATE and NOCHECK options are specified. 



when both the 



Medial initialization includes the actions of minimal 
initialization, as well as validation of the existence and 
content of each track's home address and record 0. Validation 
ensures that the proper track address (cylinder and track) 
appears in both the home address and record on each track, and 
that a standard record exists on each track. When initializing 
3350 volumes to convert from native mode to 3330-compatible mode 
volumes or the reverse, validation rewrites the home address and 
record on each track. 

The alternate track area is compressed and new alternates will 
be assigned for defective primary tracks. The flag byte in the 
home address for each primary track is examined and, when the 
defective-track flag is ON, an alternate track is assigned for 
the primary track. 
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INITIALIZING A VOLUME AT THE MAXIMAL LEVEL 



SYNTAX 



A volume is initialized 
parameter is specified. 



at the maximal level when the CHECK 



Maximal initialization includes the actions of minimal and 
medial initialization, as well as checking of track surfaces. 

Track checking is performed for 3375 and 3380 devices if surface 
checking detects a data check on the volume. The primary track 
continues to be used until the number of defects exceeds 7 and 
an alternate track is then assigned. In addition, further track 
checking is automatically performed for cylinder track and 
the first track of the VTOC (before the volume label or the 
format-4 DSCB is written). If possible, all defects are skipped 
on these tracks. If this is not possible (more than 7 defects), 
an alternate track is assigned. 



Command 


Required Parameters 


INIT 


UNITADDRESS(cuu)) 

DDHAME(dname)| 

SYSNAME(sysxxx) 
VERIFY(serialC , owner]) | 

NOVERIFY 


Optional Parameters 


DEVICETYPE(devtype) 

PURGE INOPURGE 

CHECKCnlTNOCHECK 

VALIDATE 1 HOVALIDATE 

RECLAIM INQRECLAIM 

VTCC(cyli nder, trackC , extent 3 ) 

DOSVTOC 

(cyl i nder, trackC , extent] ) 
INDEX 

(cyl i nder, trackC , ex tent] ) 

VOLID(serial) 

OHNERID( owner) 

LAEELS(n) 

IPLDD( (dnameldlblname} 

COB J FORMAT 1 , ABSFORMAT]) 
BOOTSTRAP 1 NOBOOTSTRAP 
MIMIC(devtype) 
MAPlNOMAP 



UNITADDRESSlDDNAMElSYSNAME: 
MOUNTED 



IDENTIFYING THE DEVICE ON HHICH THE VOLUME IS 



Explanation: UNITADDRESS(cuu) iDDNAME( dname ) |SYSNAME( svsxxx ) are 

required parameters identifying the volume that is to be 
initialized. When you initialize a volume for the first time 
under OS/VS or DOS/VSE, the volume must be mounted offline 
because it contains no volume label and is not acceptable to an 
operating system. 

UNITADDRESS 

Required when initializing a volume that is mounted offline 
or when initializing a volume in a stand-alone environment. 
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For cuu , specify the address, in hexadecimal, of the 
channel and unit on which the volume is mounted. 

Note-* The device must be on a channel that is online. If 
the device is on a channel that is offline, the program 
might enter a nontermi nat i ng wait state. 

DDNAME 

Required when initializing a volume that is mounted online 
in the OS/VS environment. The device on which the volume is 
mounted must be online and the volume mounted as PRIVATE 
with DISP=0LD specified. 

For dnam e, specify the OS/VS JCL DD statement that 
identifies the device on which the volume is mounted. 

SYSNAME 

Required when initializing a volume in the DOS/VSE 
environment. For s ysxxx , specify the SYSNAME specified in 
the ASSGN control statement. 

Abbreviations: 

UNITADDRESSIUNIT 
DDNAME I DNAME 

Restrictions: The UNITADDRESS parameter cannot be specified when 
initializing a volume that is mounted online. 

The DDNAME parameter cannot be specified when initializing a 
volume that has not been previously initialized or when the 
volume is in a stand-alone environment or the DOS/VSE 
envi ronment . 

The SYSNAME parameter cannot be specified when initializing a 
volume in the stand-alone or OS/VS environment. 



VERIFY INOVERIFY: VERIFYING THE VOLUME SERIAL NUMBER AND OUNER IDENTIFICATION 

Explanation: VERIFY( serial C, owner 3 ) INOVERIFY are required 
parameters specifying whether to verify the volume serial number 
and owner identification before initializing the volume. 

VERIFY 

Required when you want to verify the volume serial number 
and owner identification before initializing the volume. If 
the volume serial number or owner identification does not 
match that found on the volume, the INIT command 
terminates. 

For seri al , substitute one to six alphameric characters for 
the volume serial number. 

For owner , substitute one to fourteen alphameric characters 
for the owner identification. 

NOVERIFY 

Required when you want to bypass verification of the volume 
serial number and owner identification. 

Abbreviations: 

VERIFYlVFY 
NOVERIFYlNpVFYlNVFY 

Defaults: None. 

Restrictions: You cannot verify the owner identification 
separately from the volume serial number; both the volume serial 
number and the owner identification must be verified when you 
want to verify the owner identification. 
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When you specify the VERIFY parameter and verification fails* 
the command terminates. 



DEVICETYPE: IDENTIFYING THE TYPE OF DEVICE 



Explanation: DEVICETYPE(devtype) is required in a stand-alone 
environment when the MIMIC(MINI) or MIMIC(EMU) parameter is 
specified. 

For devtype , substitute one to eight characters for the type of 
device on which the volume is mounted. See Figure 2 on page 4 
for valid device types. 

Abbreviations^ 

DEVICETYPE | DEVTYPE I DEVTYP 

Defaults: None. 

Restrictions: The DEVICETYPE parameter applies only when you 
Qre initializing a volume in a stand-alone environment and 
MIMIC(MINI) or MIMIC(EMU) is specified. If DEVICETYPE is 
specified when it does not apply* it will be ignored. 

When initializing a 3350 Direct Access Storage volume in 
3330-compati bi 1 i ty mode, the device type must be specified as 
3330 or 3330-11, as required. The 3333 Disk Storage and Control 
Models 1 and 11 must be specified as 3330 and 3330-11, 
respectively. 



PURGE INOPURGE: WRITING OVER DATA ON A PREVIOUSLY INITIALIZED VOLUME 



Explanation: PURGE I NOPURGE are optional parameters that specify 
whether you want to write over the data in the following types 
of data sets during initialization 1 

• Unexpi red 

• VSAM 

• Password-protected 

• RACF-protected 

PURGE specifies that you want to write over the data. NOPURGE 
specifies that you do not want to write over the data. For more 
information on execution of the PURGE and NOPURGE parameters, 
see the section "Data Set Security and Protection." 



A volume that appears to contain real data cannot be 
unless the PURGE parameter is specified. 



PURGE 



initial! zed 



Indicates that you want to write over existing data during 
initialization. For more information about the actions 
taken when data is found on the volume, 
Security and Protection" earlier 



see "Data 
thi s book. 



Set 



NOPURGE 

Indicates that you do not want to write over existing data 
If a volume appears to contain real data, it cannot be 
initialized unless the PURGE parameter is specified. 

Abbreviations: 

PURGElPRG 
NOPURGElNOPRGlNPRG 
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Defaults: The default is NOPURGE. 

Restrictions: The NOPURGE parameter does not apply in offline 
mode or in a stand-alone environment. If you initialize a volume 
in offline mode or in a stand-alone environment* all existing 
data on the volume is purged, regardless of whether the data is 
unexpired or password protected. 



CHECK I NOCHECK: SURFACE CHECKING OF THE VOLUME 

Explanation-* CHECK(n) I NOCHECK are optional parameters 
specifying whether the tracks are to be checked for recording 
errors. Each track is surface checked by writing and reading 
specially patterned records. Upon satisfactory completion of 
surface checking, each checked track is rewritten with a 
standard record 0. If surface checking identifies a defective 
primary track, the track is flagged, and an alternate track is 
assigned to it. If an alternate track is identified as 
defective, it is flagged as defective and treated as unavailable 
and, if it is associated with a primary track, the primary track 
is assigned a different alternate track. 

CHECK 

Indicates that you want each track to be checked for 
recording errors during initialization. This parameter 
erases the contents of each track during initialization. 

For n, substitute a decimal number from 1 through 10 for 
the number of times you want each track to be checked. 
Because there ar& two special alternating bit patterns used 
during checking, you may wish to specify two or more cycles 
of checking to allow both bit patterns to be used to detect 
surface defects. Note, however, that each additional 
checking cycle significantly increases the time required 
for initialization. 

NOCHECK 

Indicates that you do not want the tracks to be surface 
checked for recording errors during initialization. 

Abbreviations: 

CHECK jCHK 
NOCHECKlNOCHKlNCHK 

Defaults: The default is NOCHECK. 

Restrictions: The maximum number you can specify with the CHECK 
parameter is 10 . 



VALIDATE INOVALIDATE: VALIDATING THE HOME ADDRESS AND RECORD 

Explanation: VALIDATE I NOVALIDATE are optional parameters 
specifying whether to validate the home address and record for 
each track. Validation is less time-consuming than surface 
checking, but does read and validate the home address and record 
on each track. Validation causes the remainder of the data on 
a track to be erased by writing a record 0. 

VALIDATE 

Indicates that you want to validate the home address and 
record for each track during initialization. When you 
specify VALIDATE with the NOCHECK parameter, you initialize 
the volume at the medial level. When you specify VALIDATE 
with the CHECK parameter, you initialize the volume at the 
maximal level, because the CHECK parameter supersedes the 
VALIDATE parameter. 
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NOVALIDATE 

Indicates that you do not want to validate the home address 
and record for each track during initialization. When you 
specify NOVALIDATE with the NOCHECK parameter, you 
initialize the volume at the minimal level. 

Abbreviations: 

VALIDATElVAL 
NOVALIDATE|NOVAL|NVAL 

Defaults: The default is NOVALIDATE, unless the CHECK parameter 
i s speci f i ed. 

Restrictions: The VALIDATE and NOVALIDATE parameters are 
ignored when the CHECK parameter is specified. 



RECLAIM iNORECLAIM: RECLAIMING TRACKS PREVIOUSLY FLAGGED DEFECTIVE 

Explanation: RECLAIM I NORECLAIM are optional parameters 
specifying whether to reclaim tracks that were previously 
flagged defective but appear to be usable after surface 
checking. 

Because surface checking is not as exacting as that performed by 
the manufacturer using special hardware analysers, later use of 
the track can show previously undetected track defects. 

RECLAIM 

Indicates that you want tracks that are identified as 
usable by surface checking to be reclaimed during 
initiali za tion. 

NORECLAIM 

Indicates that you want to suppress track reclamation 
during initialization. 

Abbreviations: 

RECLAIM|RCLM 
NORECLAIM | NORCLM | NRCLM 

Defaults: The default is NORECLAIM. 

Restrictions: The RECLAIM parameter applies only when the CHECK 
parameter has been specified. If RECLAIM is specified with 
NOCHECK, it will be ignored. 

The RECLAIM parameter does not apply when initializing Model 
2305 Fixed Head Storage Models 1 and 2. 



VTOC: SPECIFYING THE VOLUME TABLE OF CONTENTS IN OS/VS 

Explanation: VTOCC cvl inder, track E , extent 3) is an optional 
parameter specifying the location and size of the volume table 
of contents. 

For cyl i nder , track , specify one to four decimal (n) or 
hexadecimal (X'n') numbers to identify the cylinder and one to 
four decimal (n) or hexadecimal (X'n') numbers to identify the 
track where the volume table of contents is to be placed. 

For extent , specify one to five decimal (n) or hexadecimal 
(X'n') numbers for the number of tracks that are to be reserved 
for the volume table of contents. 
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Defaults: The default for cvli nder, track is 0,1; when 
initializing a Mass Storage System staging pack* however, the 
default is 0,2. 

The default for extent is one track. 

Restrictions 5 The VTOC parameter is ignored if it is specified 
with the MIMIC(MSS) parameter. 

A VTOC cannot be placed at cylinder 0, track 0. 



DOSVTOC: SPECIFYING THE VOLUME TABLE OF CONTENTS IN DOS/VSE 

Explanation: D0SVTOC( cvli nder ,t rack [ > extent ]) is an optional 
parameter specifying the location and size of the volume table 
of contents. 

For cvli nder, track specify one to four decimal (n) or 
hexadecimal (X'n') numbers to identify the cylinder and one to 
four decimal (n) or hexadecimal (X'n') numbers to identify the 
track where the volume table of contents is to be placed. 

For extent , specify one to five decimal (n) or hexadecimal 
(X'n') numbers for the number of tracks that are to be reserved 
for the volume table of contents. 

Abbreviations: 

DOSVTOC | DVTOC 

Defaults: None. 

Restrictions: If neither VTOC nor DOSVTOC is specified, the 
default taken is an OS/VS VTOC at cylinder 0, track 1, except 
for MSS, where it is cylinder 0, track 2. 

A VTOC can not be placed at cylinder 0, track 0. 



INDEX; CREATING A VTOC INDEX 

Explanation: INDEX(cylinder,track[ , extent]) is an optional 
parameter specifying the starting location and size of the index 
data set. Values for subparameters cvli nder and track are 
required; specification of extent is optional. 

For cvl i nder and track , specify one to five decimal or 
hexadecimal numbers to identify the cylinder number, and one to 
five decimal numbers to identify the track number within the 
cylinder where the index is to start. Hexadecimal numbers may be 
entered by preceding the value with the letter "X" and enclosing 
the hexadecimal number in single quotation marks. 

Eor extent , specify one to five decimal or hexadecimal numbers 
for the number of tracks that are to be reserved for the index 
data set. Hexadecimal numbers may also be entered, as for the 
cvli nder and track subparameters. 

Example : INDEXC 10 , 11 , 12) This specification will cause the 
index to be placed starting at cylinder 10, track 11 for a total 
of 12 tracks. Expressed in hexadecimal: INDEXCX' A ' ,X'B f ,X'C ) 

Abbreviations: None. 

Defaults: No defaults will be taken for cyli nder or track . The 
default for extent is an internal calculation based on the 
number of tracks in the VTOC. 
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Restrictions: The IBM 2314, 3310, 3370, and MSS staging volumes 
are not supported by the INDEX parameter. All other devices, 
including VM/370 minidisks, are supported. 

This parameter is ignored in the DOS/VSE environment. 



VOLIP: SPECIFYING THE VOLUME SERIAL NUMBER 



Explanation: VOL ID (serial) 
the volume serial number 



y i s an optional parameter specifying 
to be written in the volume label. 



For serial , substitute one to six alphameric characters for the 
volume serial number. If fewer than six characters are 
specified, the serial is left-justified, and the remainder of 
the field is padded with blanks (X'40 f ). 

Abbreviations: None. 

Defaults: When you initialize a volume that was previously 
initialized and do not specify the VOLID parameter, the old 
volume serial number remains unchanged. 

Restrictions: When you initialize a volume for the first time, 
you must specify the VOLID parameter, or the INIT command 
termi nates. 

If you change the volume serial number of a volume that is 
mounted online, thereafter you must reference the volume by the 

new volume serial numbei even though the reference may occur in 

the same step. 



OMNERIP: SPECIFYING THE VQLUME-OMNER IDENTIFICATION 

Explanation: OHNERID( owner ) is an optional parameter specifying 
the volume-owner identification to be written in the volume 
label. 

For owner , substitute 1 to 14 alphameric characters for the 
volume-owner identification to be written in the volume label. 

Abbreviations: 

OWNERIDlOWNER 

Defaults: The default for owner during a first-time 
initialization is 14 blanks. 

If you do not specify OWNERID when reinitializing a previously 
initialized volume, the owner identification remains unchanged. 

Restrictions: None. 



LABELS: RESERVING SPACE FOR ADDITIONAL VOLUME LABELS 

Explanation: LABELS(n) is an optional parameter specifying that 
space on cylinder 0, track i s to be reserved for additional 
volume labels, also known as user volume labels. In addition to 
the label that must be written on the volume, a maximum of nine 
additional volume labels can be specified. 

Note: A special program module, ICKVLBL, is provided to allow 
you to create the contents of the user volume labels. The module 
is replaced by a usei — written module with the same name. The 
microfiche listing for the module contains the information about 
replacing the module. If you do not format the user volume 
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labels during i ni tiali zati on, a string of blanks is written in 
each user volume label. 

For n, substitute a decimal number from 1 through 9 for the 
number of additional volume labels to be placed on the volume 
during initialization. 

Abbreviations: 

LABELS|LABEL|LBL 

Defaults: None. 

Restrictions: If LABELS is not specified when you initialize a 
volume that was previously initialized, any user volume labels 
that existed from a previous initialization are destroyed. 

If a value greater than 9 is specified with the LABELS 
parameter, the INIT command terminates. 

The LABELS parameter is ignored when the MIMIC(MSS) parameter is 
speci f i ed. 



IPLDP: WRITING A USER-SUPPLIED IPL PROGRAM ON THE VOLUME 

Explanation: IPLDDC ( dnameldlblname H ,QBJFORMATl , ABSFORMATl ) is 
an optional parameter which allows you to supply an IPL program 
to be written on the volume during initialization. 

The IPLDD and BOOTSTRAP parameters are used to specify one of 
the following: 

• If you do not specify IPLDD, ICKDSF writes special bootstrap 
records that cause the processing unit to be placed in a 
WAIT state if the volume is specified during an attempt to 
load the system. 

• If you specify IPLDD but do not specify BOOTSTRAP, ICKDSF 
supplies an IPL bootstrap which is written on the volume 
during initialization together with the IPL text you supply. 

• If you specify IPLDD and BOOTSTRAP, ICKDSF uses the IPL 
bootstrap and the IPL text you supply. If neccesary, ICKDSF 
updates the bootstrap records to allow for possible user 

labels. 

The maximum size permitted for the IPL program record depends 
upon the type of volume being initialized. The maximum sizes 
allowed are : 



Volume Type 


Maximum Bytes for IPL Program 


2305-1 


12,180 


2305-2 


13,616 


2311 


3,110 


2314 


6,514 


2319 


6,514 


3330 


12,117 


3330-11 


12,117 


3340 


7,286 
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Volume Type 


Maximum Bytes for IPL Program 


3344 


7,286 


3350 


17,902 


3375 


33,984 


3380 


44,948 



Also, the number of additional user volume 
limit the size allowed for the IPL program, 
program that exceeds the size allowed, you 
message but initialization continues. 



labels can further 

If you supply an IPL 
receive an error 



For dname , substitute 1 to 8 alphameric characters for the DD 
statement identifying the data set that contains the IPL program 
you want written on the volume being initialized. The IPL 
program can be included within the OS/VS JCL input stream 
(SYSIN). If the IPL program is in the OS/VS JCL input stream, 
the data must be included immediately after the INIT command. 
For initialization in a stand-alone environment, the dname must 
be specified as SYSIN. 

P° r dlblname , substitute 1 to 7 alphameric characters. These 
represent the file name that appears in the DLBL statement and 
identify the file that contains the IPL program you want written 
on the volume being initialized. The IPL proaram can be included 
in the DOS/VSE JCS input stream (SYSIN). It must then be 
included immediately after the INIT command. 

OBJ FORMAT 

Specifies that IPL data is being supplied in object deck 
format; that is, cards will have one of the following 
strings of EBCDIC characters in columns 2 through 4: 

TXT 
RLD 
ESD 
END 

Note that only cards with TXT will be processed. All others 
will be ignored. 

OBJFORMAT may be abbreviated as OBJECT or OBJ. 

ABSFORMAT 

Specifies that IPL data is being supplied in the form of 
variable-length records that contain executable 
instructions. When IPL data is supplied in this format, it 
is necessary to provide a minimum of three records. The 
maximum number of records supplied and their lengths are 
only limited by the track capacity of the volume on which 
these records are to be written. 

The first two records supplied must be the bootstrap 
records and are restricted to lengths of 24 and 144 bytes, 
respect i vely . 

The contents of the IPL records and the contents of the 
program are not checked by ICKDSF. It is the user's 
responsibility to ensure that the IPL records can load an 
executable program. The first IPL record must contain a PSW 
followed by two CCWs (channel command words). The CCWs 
should have the following hexadecimal formats J 



First CCW 
Second CCW 



06xxxxxx 60000090 
08xxxxxx 00000000 
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The first CCW is a command to read in the second IPL record 
at main storage address xxxxxx. The second CCW is a 
transfei — in-channel command (a branch) to the CCW that 
begins the second IPL record. 

The second IPL record must be 144 bytes long. Bytes 32 
through 42 (starting from byte 0) cannot be used. Bytes 32 
through 42 are used by ICKDSF for the seek address (bytes 
32 through 37) and the CCHHR (bytes 38 through 42) of the 
thi rd IPL record. 

The third through nth records that are supplied are assumed 
to be IPL program records and will be written on the 
volume, without any modification, after the standard volume 
label and any existing user volume labels. Note that the 
IPL program will only be written on the first track of the 
pack. If the records supplied exceed in length the 
remaining space on the first track, the function will 
terminate with an error message. 

ABSFORMAT may be abbreviated as ABSOLUTE or ABS. 

Abbreviations: 

IPLDDllPL 

Defaults: The system provides special IPL bootstrap records if 
you specify the IPLDD parameter without specifying the BOOTSTRAP 
parameter. 

Restrictions: The IPLDD parameter is ignored when the MIMIC(MSS) 
parameter is specified. 

To initialize a volume in a stand-alone environment, you must 
substitute SYSIN for the dname . 

When an IPL program is included in the SYSIN stream, it must 
immediately follow the INIT command and be terminated by an 
ENDIPLTEXT card. The ENDIPLTEXT card is optional when the IPL 
program is in a data set other than the one specified by SYSIN, 
or when the end-of-f i le indicator (/*) immediately follows the 
data for the IPL program. 



BOOTSTRAP INOBOOTSTRAP: MRITING IPL BOOTSTRAP RECORDS ON THE VOLUME 

Explanation: BOOTSTRAP 1 NOBQQTSTR AP are optional parameters 
specifying whether you are supplying the IPL bootstrap records 
that are to be written on the volume during initialization. 



BOOTSTRAP 

Indicates that you are supplying the IPL b 
that are written on the volume during init 
records must be the first four records in 
text. The first text record must have IPL1 
four columns, followed by 24 bytes of data 
have the same format as the first IPL reco 
above under ABSFORMAT. The next three text 
have IPL2 in their first four columns, fol 
of data each in the second and third recor 
data in the last record. These 144 bytes o 
same format as IPL record 2 described abov 
ABSFORMAT. 



ootstrap records 
ialization. These 
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NOBOOTSTRAP 

Indicates that you want the system to supply the IPL 
bootstrap records that are written on the volume during 
i ni t i al i zat i on. 
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Abbreviations: 

BOOTSTRAP | BOOT 
NOBOOTSTRAP |NOBOOT|NBOOT 

Defaults: The default i s NOBOOTSTRAP . 

Restrictions: The BOOTSTRAP and NOBOOTSTRAP parameters apply 
only when the IPLDD parameter is specified. This parameter is 
ignored when the IPL program is supplied in absolute format. 



mimic: specifying a special volume usage format 

Explanation: MIMIC(devtype) is an optional parameter specifying 
a special usage format for the volume being initialized. You may 
specify MINI(n), MSS, EMU(n), or EMUALL. 

MlNI(n) 

Indicates that an OS/VS minidisk is to be initialized for a 
VM/370 environment, n represents the number of cylinders 
that are to comprise the minidisk. Details of this support 
sre in Appendix B. 

MSS 

Indicates that the volume is to be formatted as a Mass 
Storage System staging pack. A one-track volume table of 
contents is created on cylinder 0, track 2 with a format-5 
data set control block (DSCB) indicating that no tracks are> 
available for allocation. 

When initializing a 3330 as a Mass Storage System staging 
pack, cylinders through 408 are identified as primary 
cylinders, and cylinders 409 and 410 are identified as 
alternate cylinders. 

When initializing a 3330-11 as a Mass Storage System 
staging pack, cylinders through 808 are identified as 
primary cylinders, and cylinders 809 through 814 are 
identified as alternate cylinders. 

EMUtn) 

Indicates that a partial CKD disk emulated on a fixed block 
device is to be initialized. In a stand-alone environment, 
you must also specify the DEVICETYPE parameter. 

EMUALL 

Indicates that a full CKD disk emulated on a fixed block 
device is to be initialized. 

Abbreviations: None. 

Defaults: None. 

Restrictions: A volume being initialized as a Mass Storage 
System staging pack must be initialized offline at the medial or 
maxi mal level . 

The MINI(n) parameter is valid in a stand-alone environment 
only, and requires the DEVICETYPE parameter to be specified. 

When the MIMIC(MSS) parameter is specified, the VTOC, LABELS, 
and IPLDD parameters do not apply and are ignored. 

The only device types that are valid with the MIMIC(MSS) 
parameter are: 3330 and 3330-11. 

An emulated 3330 on a fixed block device has limited function 
and only minimal initialization is possible on this device; 
hence parameters such as CHECK(n), VALIDATE, and RECLAIM do not 
apply. 
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MAPlNOHAP: PRINTING A VOLUME MAP 

Explanation 1 MAP lNOMAP are optional parameters specifying 
whether to print a volume map during initialization. The volume 
map lists tracks that are found to be defective during 
i ni ti al i zati on . 

MAP 

Indicates that you want to print a volume map during 
initiali zati on. 

NOMAP 

Indicates that you do not want to print a volume map during 
i ni t i ali zati on. 

Abbreviations: None. 

Defaults: The default is MAP. 

Restrictions: None. 

EXAMPLES OF MAYS TO CODE THE INIT COMMAND 

The following examples show different ways to code the INIT 
command. Most are for the offline and online modes of OS/VS. To 
initialize a volume in a stand-alone environment, do the 
f ollowi ng: 

• Eliminate the OS/VS JCL. 

• Substitute the UNITADDRESS parameter for the DDNAME 
parameter. 

• Specify the DEVICETYPE parameter. 

• Substitute SYSIN for dname if the IPLDD parameter is 
speci f i ed. 

To initialize a volume in the D05/VSE environment, do the 
f ollowi ng: 

• Replace the OS/VS JCL statements with DOS/VSE system control 
statements. 

• Substitute the SYSNAME parameter for the DDNAME parameter. 

• Substitute dlblname for dname if the IPLDD parameter is 
specified and the data set is located on a direct access 
volume. If the data set is included in stream, replace the 
dname with either SYSIN or SYSIPT. 

• Introduce the DOSVTOC parameter if a DOS type VTOC is 
required on the volume. 

Note: Any values specified here are examples only and should not 
be interpreted as the values for your system. 

INITIALIZING A VOLUME FOR THE FIRST TIME IN OFFLINE MODE (OS/VS): EXAMPLE 1 

In this example, a volume is initialized at the minimal level 
because neither the CHECK nor VALIDATE parameter is specified. 
Because the volume is being initialized for the first time, it 
must be mounted offline, and the volume serial number must be 
specified. Because the VTOC parameter is not specified, the 
program supplies a default volume table of contents at cylinder 
0, track 1 that occupies one track. Initialization in offline 
mode causes any existing data to be purged, regardless of 
whether it is unexpired or password protected. 
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//EXAMPLE1 JOB 
// EXEC PGM=ICKDSF 

//SYSPRINT DD SYSOUT=A 
//SYSIN DD * 
INIT UNITADDRESSC353) NOVERIFY V0LIDCV0L123) - 
OWNERID(PAYROLL) 
/* 

INITIALIZING A VOLUME AT THE MINIMAL LEVEL IN ONLINE MODE (OS/VS): EXAMPLE 2 
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//EXAMPLE2 JOB 



// 
//XY2987 



EXEC 
DD 



//SYSPRINT DD 



//SYSIN 



DD 



PGM=ICKDSF 

UNIT=3330,DISP=OLD,VOL=SER=PAY456 

SYS0UT=A 



INIT DDNAMECXYZ987) NOVERIFY 
/x 



INITIALIZING A VOLUME AT THE MEDIAL LEVEL IN A STAND-ALONE ENVIRONMENT: 
EXAMPLE 3 
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INIT UNITADDRESSC272) - 

VERIFYCV0L123 PAYROLL) VALIDATE VT0C(42,X'C f ,3) 

INITIALIZING A VOLUME AT THE MAXIMAL LEVEL IN A STAND-ALONE ENVIRONMENT: 
EXAMPLE 4 
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INITIALIZING TWO VOLUMES IN OFFLINE MODE (OS/VS): EXAMPLE 5 
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The second INIT command initializes a volume at the minimal 
level. The volume serial number and owner identification remain 
unchanged. A default volume table of contents is written at 
cylinder 0, track 1 and occupies one track. Because the volume 
is being reinitialized in offline mode, all existing data is 
purged, regardless of whether it is unexpired or password 
protected. 



//EXAMPLE5 JOB 
// EXEC 

//IPLDECK DD 



PGM=ICKDSF 
x 



/x 

//SYSPRINT DD SYS0UT=A 
//SYSIN DD X 
INIT UNITADDRESS(353) VALIDATE V0LIDCAAA789) - 
OWNERID(SMITH) VERIFYCXYZ123) - 
IPLDD(IPLDECK) BOOTSTRAP LABELSC4) NOMAP 
INIT UNITADDRESS(271) NOVERIFY 
/x 



INITIALIZING A VOLUME AT THE MEDIAL LEVEL IN OFFLINE MODE 
STORAGE SYSTEM STAGING PACK: EXAMPLE 6 



(OS/VS) AS A MASS 



In this example, the VALIDATE parameter without the CHECK 
parameter causes medial level initialization. The volume serial 
number and owner identification are not changed. A default 
volume table of contents begins at cylinder 0, track 2 and 
occupies one track. Because the volume is being reinitialized in 
offline mode, all existing data is purged, regardless of whether 
it is unexpired or password protected. 

//EXAMPLE6 JOB 
// EXEC PGM=ICKDSF 

//SYSPRINT DD SYS0UT=A 
//SYSIN DD x 
INIT UNITADDRESSC253) NOVERIFY VALIDATE - 
MIMIC(MSS) 
/x 

INITIALIZING A MINIDISK IN A STAND-ALONE ENVIRONMENT: EXAMPLE 7 

In this example, a mini 2314 is initialized without an IPL 
program. It provides 19 primary cylinders and one alternate 
cylinder on unit 150. The VTOC is located on cylinder 1, track 
1, and is one track long labeled 231401. The surface is checked 
and if any tracks are found to be defective, alternate tracks 
are assigned. The label and VTOC are written in OS format. 

INIT UNITADDRESSC150) NOVERIFY DEVICETYPEC2314) - 

MIMICCMINH20)) VT0C(1,1,1) VOLIDC231401) CHECKC5) 
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INITIALIZING A MINIDISK IN A STAND-ALONE ENVIRONMENT: EXAMPLE 8 

In this example* a mini 3330 is initialized without an IPL 
program. It provides 30 primary and no alternate cylinders on 
unit 151. The VTOC is written on a default location of cylinder 
0, track 1 for a length of one track. The volume is labeled 
333000. The IPL program supplied as the input deck is written on 
cylinder 0, track 0. The label and VTOC are written in OS 
format . 

INIT UNITADDRESSU51) NOVERIFY DEVICETYPEC3330 ) - 
MIMIC(MINI(30)) VOLIDC333000) IPLDD(SYSIN) 

INITIALIZING A VOLUME AT MINIMAL LEVEL IN THE DOS/VSE ENVIRONMENT: EXAMPLE 9 

In this example, a volume is initialized at a minimal level 
under DOS/VSE. A DOS/VSE format VTOC is written on cylinder 32, 
track for a length of 20 tracks. The volume is labeled 231401. 



// 


JOB 


jobname 


// 


ASSGN 


SYS002,151 


// 


EXEC 


ICKDSF,SIZE=256K 




INIT 


SYSNAMECSYS002) NOVERIFY 
VOLIDC231401) 


/* 






/I 







DOSVTOC (32,0,20) - 



INITIALIZING AN EMULATED PARTIAL DISK AT MINIMAL LEVEL IN THE DOS/VSE 
ENVIRONMENT: EXAMPLE 10 

In this example, an emulated partial disk is initialized under 
DOS/VSE. A DOS/VSE format VTOC is written at cylinder 0, track 1 
for a length of 1 track. The volume is labeled AA2311. 



// 
// 
// 



/* 
/* 



JOB jobname 
ASSGN SYS000,353 
EXEC ICKDSF,SIZE=256K 
INIT SYSNAME(SYSOOO) NVFY DVTOCC0 
V0LID(AA2311) MIMICC EMUC20 ) ) 



1,1) 



INITIALIZING A VOLUME WITH AN INDEX (OS/VS): EXAMPLE 11 

This example is similar to Example 2, above, but as a result of 
this command an index to the VTOC is created. 

// JOB 

// EXEC PGM=ICKDSF 

//XYZ987 DD UNIT=3375 ,DISP=0LD, V0L=SER=PAY456 

//SYSPRINT DD SYS0UT=A 

//5YSIN DD * 

INIT DDNAMECXYZ987) NOVERIFY INDEXC 10 , 11 ,2) 
/x 
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inspect; inspecting a volume for defective tracks 



After initialization, you can use the INSPECT command to inspect 
an apparently defective volume to detect defective tracks and to 
assign alternate tracks, or to reclaim tracks that were 
previously flagged defective. Several options are available for 
i nspect i on ' 

• The TRACKS and ALLTRACKS parameters are provided to inspect 
individual tracks or all the tracks. 

• The CHECK parameter is provided to check each track surface 
and to permit optional specification of the number of 
checking cycles that are to be performed on each track being 
inspected. Normally, an alternate track is assigned to a 
primary track only after an inspection of the track surface 
reveals defects. The NOCHECK parameter suppresses such 
checking and, unless alternate track assignment is 
suppressed, an alternate track will be unconditionally 
assigned to a defective track. 

• The PRESERVE parameter is provided to save data that would 
normally be destroyed during track inspection. Before a 
track is inspected, its contents are read and saved. After a 
track is inspected and found to be nondef ect i ve , the saved 
data contents are written back on the same track. If a track 
is found to be defective, the saved data contents are 
written on an assigned alternate track. The NOPRESERVE 
parameter allows the track inspection to destroy the data 
content of a track. 



The RECLAIM parameter is provided to reclaim a track that 
was previously flagged defective, but track inspection has 
determined is capable of recording data. The NORECLAIM 
parameter suppresses automatic track reclamation. 

The ASSIGN parameter automatically assigns alternate tracks 
for primary or alternate tracks that are found to be 
defective. Automatic assignment of alternate tracks is 
suppressed by the NOASSIGN parameter. 

The MAP parameter provides printed output of the detailed 
status of each track. The NOMAP parameter suppresses the 
printed output. 

For 3375 and 3380, when TRACKS is specified, ICKDSF performs 
surface checking to locate and skip over defective areas on 
the track. If the primary track contains more than seven 
defects, an alternate track is assigned. 



INSPECTING A VOLUME TO ASSIGN ALTERNATE TRACKS 



A track can be flagged as defective, and an alternate track 
assigned, either conditionally or unconditionally. You can 
control the assignment of alternate tracks as follows- 

• Issue the INSPECT command and specify the CHECK and ASSIGN 
parameters to detect defective primary and alternate tracks. 
If a primary or alternate track is identified as defective 
by surface checking, the track is flagged as defective, and 
an alternate track is assigned to the defective track. 

• For the 3375 and 3380, issue the INSPECT command and specify 
CHECK with TRACKS to initiate surface checking for defects. 
An alternate track is assigned only if more than seven 
defects are detected. 
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• Issue the INSPECT command and specify the NOCHECK and ASSIGN 
parameters to unconditionally assign alternate tracks for 
the tracks inspected. 

To inspect primary and alternate tracks, but to prevent 
assignment of alternate tracks, issue the INSPECT command and 
specify the NOASSIGN parameter. 



INSPECTING A VOLUME TO RECLAIM TRACKS 



As alternate tracks are assigned, either unconditionally or 
conditionally, their number decreases. A volume can reach a 
point at which the volume becomes unusable because of the 
reduced number of alternate tracks available. 

Both primary and alternate tracks can be reclaimed. The surface 
checking performed by Device Support Facilities to reclaim 
tracks is not as exacting as that performed by the manufacturer 
using special hardware analyzers, and later use of the track can 
show previously undetected defects. You control track 
reclamation by using the RECLAIM or NORECLAIM parameter of the 
INSPECT command. 

For the 3375 and 3380, specifying RECLAIM with TRACKS causes 
ICKDSF to attempt to recover defective tracks by skipping over 
defective areas on the tracks. More than seven defects causes an 
alternate track to be assigned. Note that the surface checking 
information mentioned above, which is collected by the 
manufacturer, is not reset by ICKDSF processing. 

The abbreviation for the INSPECT command is INSP. 



SYNTAX 



Command 


Required Parameters 


INSPECT 


UNITADDRESS(cuu)| 

DDNAME(dname) I 

SYSNAME(sysxxx) 
TRACKS C(cylinder,t rack )[,. . .3)1 

ALLTRACKS 
VERIFYCserial C,owner])| 

NOVERIFY 


Optional Parameters 


DEVICETYPE(devtype) 
CHECK (n)| NOCHECK 

reclaim 1 noreclaim 
preserve i nopreserve 
mapFnohap 
assign | noassign 

MIMIC(devtype) 



UNITADDRESSlDDNAMElSYSNAMEt IDENTIFYING THE DEVICE HHERE THE VOLUME IS MOUNTED 

Explanation: UNITADDRESSCcuu) | DDNAME ( ddname ) 1 SYSNAMEC svsxxx) 
are required parameters identifying the volume that is to be 
i nspected. 

UNITADDRESS 

Required when inspecting a volume that i s mounted offline 
or when inspecting a volume in a stand-alone environment. 



62 Device Support Facilities User's Guide and Reference 



INSPECT 

For cuu , specify the address in hexadecimal of the channel 
and unit on which the volume is mounted. 

Note: The device must be on a channel that is online. If 
the device i s on a channel that is offline, the program 
might enter a nontermi nati ng wait state. 

DDNAME 

Required when inspecting a volume that is mounted online. 
The device on which the volume is mounted must be online 
and the volume mounted as PRIVATE with DISP=0LD specified. 

For dname , specify the OS/VS JCL DD statement that 
identifies the device on which the volume is mounted. 

SYSNAME 

Required when inspecting a volume in the DOS/VSE 

environment. For sysxxx , specify the SYSNAME specified in 

the ASSGN system control statement. 

Abbreviations: 

UNITADDRESSlUNIT 
DDNAMElDNAME 

Defaults: None. 

Restrictions: The UNITADDRESS parameter cannot be specified 
when inspecting a volume that is mounted online. 

The DDNAME parameter cannot be specified when inspecting a 
volume that is mounted offline or in a stand-alone environment 
or the DOS/VSE environment. 

The SYSNAME parameter cannot be specified when inspecting a 
volume in the stand-alone or OS/VS environment. 



TRACKS lALLTRACKS: SPECIFYING UHICH TRACKS TO INSPECT 

Explanation: TRACKSCcylinder, track) lALLTRACKS are required 
parameters specifying the tracks to be inspected. For the 3375 
and 3380, if you specify either of these parameters and CHECK, 
ICKDSF tries to recover defective tracks by skipping over 
defective areas on the track if a data check occurs. 

TRACKS 

Required when inspecting individual tracks on the volume. 

For cylinder , track , specify one to four decimal (n) 
hexadecimal (X'n') numbers to identify the cylinder, and 
one to four decimal (n) or hexadecimal (X'n') numbers to 
identify the track to be inspected. 

ALLTRACKS 

Required when inspecting all the tracks on the volume. 

Note that the use of this option in conjunction with the 
CHECK(n) parameter can be time-consuming. 

Abbreviations: 

TRACKS|TRACK|TRKS|TRK 
ALLTRACKS|ALLTRACK|ALLTRKS|ALLTRK 

Defaults: None. 

Restrictions: The maximum number of individual tracks that can 
be specified with the TRACKS parameter is 20. 
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VERIFY 1N0VERIFY: VERIFYING THE VOLUME SERIAL NUMBER AND OUNER IDENTIFICATION 

Explanation: VERIFY(seriaH> owner ] ) INOVERIFY are required 
parameters specifying whether to verify the volume serial number 
and owner identification before inspecting the volume. 

VERIFY 

Required when you want to verify the volume serial number 
and owner identification before inspecting the volume. If 
the volume serial number or owner identification does not 
match that found on the volume, the INSPECT command 
termi nates. 

For seri al , substitute one to six alphameric characters for 
the volume serial number. 

For owner , substitute one to fourteen alphameric characters 
for the owner identification. 

NOVERIFY 

Required when you want to bypass verification of the volume 
serial number and owner identification. 

Abbreviations: 

VERIFYlVFY 
NOVERIFY|NOVFY|NVFY 

Defaults: None. 

Restrictions: You cannot verify the owner identification 
separately from the volume serial number. Both the volume serial 
number and owner identification must be verified when you want 
to verify the owner identification. 

When you specify the VERIFY parameter and verification fails, 
execution of the command terminates. 



DEVICETYPE: IDENTIFYING THE TYPE OF DEVICE 

Explanation: DEVICETYPE ( devtvpe ) is required in a stand-alone 
J environment when the MIMIC(MINI) or MIMIC(EMU) parameter is 
I specified. 

For devtype , substitute one to eight characters for the type of 
device on which the volume is mounted. See Figure 2 on page 4 
for valid device types. 

Abbreviations- 

DEVICETYPE | DEVTYPE | DEVTYP 
Defaults: None. 

Restrictions: The DEVICETYPE parameter applies only when you 
J are inspecting a volume in a stand-alone environment and 
I MIMIC(MINI) or MIMIC(EMU) is specified. If DEVICETYPE is 

specified when it does not apply, it will be ignored. 

When using a 3350 Direct Access Storage volume in 
3330-compati bi 1 i ty mode, the device type must be specified as 
3330 or 3330-11, as required. The 3333 Disk Storage and Control 
Models 1 and 11 must be specified as 3330 and 3330-11, 
respecti vely . 
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checkInocheck; surface checking of the volume 

Explanation: CHECK (n) INOCHECK are optional parameters 
specifying whether the tracks are to be checked for recording 
errors. Each track is surface checked by writing and reading 
specially patterned records. Upon satisfactory completion of 
surface checking, each checked track is rewritten with a 
standard record 0. If surface checking identifies a defective 
primary track, the track is flagged, and an available alternate 
track is assigned to it. If an alternate track is identified as 
defective, it is flagged and treated as unavailable and, if it 
is associated with a primary track, the primary track is 
assigned a different alternate track. 



For the 3375 and 3380, if you specify this parameter and TRACKS 

or ALLTRACKS, ICKDSF tries to recover defective tracks by 

skipping over defective areas on the track if a data check 
occurs. 

CHECK 

Indicates that you want each track to be surface checked 
for recording errors during inspection and assigned an 
alternate track only if the checked track appears 
def ect i ve. 

For n, substitute a decimal number from 1 through 255 for 
the number of times you want each track to be checked. 
Because there are two special alternating bit patterns used 
during checking, you may want to specify two or more cycles 
of checking to allow both bit patterns to be used to detect 
surface defects. 

NOCHECK 

Indicates that you do not want each track to be surface 
checked for recording errors during inspection. Alternate 
tracks are unconditionally assigned as a result of 
inspection when NOCHECK and ASSIGN are specified. 

Abbreviations: 

CHECKlCHK 
NOCHECKlNOCHKlNCHK 

Defaults: The default is CHECK(l). 

Restrictions: The maximum number of times you can specify with 
the CHECK parameter is 255. However, if the ALLTRACKS parameter 
is specified, the maximum number of times you can specify is 10; 
if a number larger than 10 is specified, the number defaults to 
10. 



RECLAIM INORECLAIM: RECLAIMING TRACKS PREVIOUSLY FLAGGED DEFECTIVE 

Explanation: RECLAIM I NORECLAIM are optional parameters 
specifying whether to reclaim tracks that were previously 
flagged defective but appear to be usable after surface 
checki ng. 

Because surface checking is not as exacting as that performed by 
the manufacturer using special hardware analyzers, later use of 
the track can show previously undetected defects. 

RECLAIM 

Indicates that you want tracks that are identified as 
usable by surface checking to be reclaimed during 
i nspect i on. 

NORECLAIM 

Indicates that you want to suppress track reclamation 
during inspection. 
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Abbreviations: 

RECLAIMlRCLM 
NORECLAIMlNORCLMlNRCLM 

Defaults: The default is NORECLAIM. 

Restrictions: The RECLAIM parameter applies only when the CHECK 
parameter has been specified. If RECLAIM is specified with 
NOCHECK, it is ignored. 

You cannot reclaim tracks on 2305 Fixed Head Storage Models 1 
and 2. 



PRESERVE INOPRESERVE: PREVENTING DESTRUCTION OF DATA ON THE TRACKS INSPECTED 

Explanation: PRESERVE INOPRESERVE are optional parameters 
specifying whether to save the data on the inspected tracks. If 
an inspected primary track is identified as defective, the data 
is rewritten on the alternate track that is assigned. If an 
alternate track that is associated with a primary track is 
identified as defective, the alternate track is flagged as 
defective, and the data is rewritten to an available alternate 
track. If a primary track that was previously flagged as 
defective is reclaimed, the data is copied from the alternate 
track to the reclaimed primary track, and the alternate track is 
made avai lable. 

If PRESERVE NOASSIGN is specified, but user data cannot be 
rewritten after it has been read, ICKDSF overrides the NOASSIGN, 
assigns an alternate track, and rewrites the data on the 
alternate track. Message ICK11328I is issued. 

PRESERVE 

Indicates that you want to save the data on the inspected 
tracks. 

NOPRESERVE 

Indicates that you do not want to save the data on the 
inspected tracks. 

Abbreviations: 

PRESERVElPRSV 
NOPRESERVE | NOPRSV | NPRSV 

Defaults: The default is PRESERVE. 

Restrictions: Note that the data area of a rewritten record 
is set to eight bytes of binary zeros. 

Caution: If you specify the NOPRESERVE parameter with either 
the CHECK or ASSIGN parameter, data on the volume will be 
destroyed. 

Note that the VTOC is no exception to this rule. Special care 
must be taken with the volume serial in an online environment. 



MAPlNOMAP: PRINTING A VOLUME MAP 

Explanation: MAP lNOMAP sre optional parameters specifying 
whether to print a volume map during inspection. The volume map 
lists tracks that are found to be defective during inspection. 

MAP 

Indicates that you want to print a volume map during 
inspection. 
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NOMAP 

Indicates that you do not want to print a volume map during 
i nspecti on. 

Abbreviations: None. 

Defaults: The default is MAP. 

Restrictions None. 

ASSIGN INOASSIGN: SPECIFYING ASSIGNMENT OF ALTERNATE TRACKS 

Explanation ASSIGN INOASSIGN are optional parameters specifying 
whether alternate tracks are to be assigned when defective 
primary and assigned alternate tracks are detected. 

ASSIGN 

Indicates that you want alternate tracks to be assigned 
when defective primary and assigned alternate tracks are 
detected. 

NOASSIGN 

Indicates that you do not want alternate tracks assigned. 

Abbreviations: 

ASSIGNjASGN 

NOASSIGN | NOASGN I NASGN 

Defaults: The default is ASSIGN. 

Restrictions: If NOASSIGN is specified with the CHECK 
parameter, an inspected track is not marked defective and an 
alternate track is not assigned. 

mimic; specifying a SPECIAL volume usage format 

Explanation: MIMIC(devtype) is an optional parameter specifying 
a special usage format for the volume being inspected. You may 
specify MINI(n), MSS, EMU(n), or EMUALL. 

MINI(n) 

Indicates that the volume to be inspected is a minidisk of 
'n T cylinders. This disk must have been previously 

I initialized. The DEVICETYPE parameter is required when this 

I parameter is specified. 

Note that this parameter is valid in the stand-alone 
environment only. See Appendix B for details of this 
support. 

MSS 

Indicates that the volume has been formatted as a Mass 
Storage System staging pack. This parameter is required 
when inspecting an MSS staging pack. 

EMU(n) 

Indicates that a partial CKD disk emulated on a fixed block 
device is to be inspected. The DEVICETYPE parameter is 
required when this parameter is specified in the 
stand-alone environment. 

EMUALL 

Indicates that a full CKD disk is emulated on a fixed block 
devi ce. 

Abbreviations: None. 
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Defaults: None. 

Restrictions: The only device types valid for MINI(n) are 2311, 
2314, and 2319. Inspection of an emulated 3330 ( EMUCn) I EMUALL ) 
is not permitted. 



EXAMPLES OF MAYS TO CODE THE INSPECT COMMAND 

The following examples show different ways to code the INSPECT 
command. Most i llustrate the use of the command in offline and 
online mode under OS/VS. To inspect a volume in a stand-alone 
environment, make the following changes to OS/VS examples: 

• Eliminate the OS/VS JCL. 

• Substitute the UNITADDRESS parameter for the DDNAME 
parameter . 

• Specify the DEVICETYPE parameter. 

• Substitute SYSIN for dname in the IPLDD parameter. 

To inspect a volume in the DOS/VSE environment, do the 
f ollowi ng: 

• Replace the OS/VS JCL statements with DOS/VSE system control 
statements. 

• Substitute the SYSNAME parameter for the DDNAME parameter. 

• Substitute dlblname for dname if the IPLDD parameter is 
specified and the data set is located on a direct access 
volume. If the data set is included in the stream, replace 
the dname with either SYSIN or SYSIPT. 

• Introduce the DOS VTOC parameter if a DOS-type VTOC is 
required on the volume. 

Note : Any values specified here are examples only and should not 
be interpreted as the values for your system. 

INSPECTING A VOLUME FOR CONDITIONAL ASSIGNMENT OF ALTERNATE TRACKS IN ONLINE 
MODE (OS/VS): EXAMPLE 1 

In this example, the assignment of alternate tracks depends on 
the results of surface checking. The data on each specified 
track is copied to an alternate track if the track is defective, 
or is written back to the primary track if the track is not 
def ect i ve. 

//EXAMPLE1 JOB 
// EXEC PGM=ICKDSF 

//VOLUMEG DD UNIT=3330 ,DISP=0LD, V0L=SER=PAY345 
//SYSPRINT DD SYS0UT=A 
//SYSIN DD * 
INSPECT DDNAME(VOLUMEG) NOVERIFY CHECK(2) - 

TRACKS ( (1 , 3 ) , (1 , 2 ) , ( 2 , ) , ( 2 , 3 ) , ( 3 , 2 ) ) 
/* 

INSPECTING A VOLUME FOR UNCONDITIONAL ASSIGNMENT OF ALTERNATE TRACKS IN OFFLINE 
MODE COS/VS): EXAMPLE 2 

In this example, the next available alternate track is assigned 
for the specified primary track. If the primary track is already 
assigned an alternate track, it will be re-assigned a different 
alternate track. The default parameter PRESERVE causes the 
contents of the specified primary track to be copied to the 
assigned alternate. 
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//EXAMPLE2 JOB 
// EXEC PGM=ICKDSF 
//SYSPRINT DD SYS0UT=A 
//SYSIN DD x 

INSPECT UNITADDRESSC273) NOVERIFY TRACKS(X'2 f , 3) NOCHECK 
/x 

INSPECTING AN ENTIRE VOLUME TO PRODUCE A VOLUME MAP IN A STAND-ALONE 
ENVIRONMENT: EXAMPLE 3 

In this example, all the tracks on the volume are inspected to 
produce a volume map that lists all the defective tracks. No 
alternate tracks are assigned. 

INSPECT UNITADDRESSC353) NOVERIFY - 
ALLTRACKS NOASSIGN 

INSPECTING A VOLUME TO RECLAIM TRACKS IN OFFLINE MODE (OS/VS): EXAMPLE 4 

In this example, a volume is inspected to reclaim tracks that 
were previously marked defective. The default parameter PRESERVE 
causes the contents of the alternate track to be copied to the 
primary track if the primary track is reclaimed. Then, the 
alternate track becomes available for future assignment. 

//EXAMPLE* JOB 
// EXEC PGM=ICKDSF 
//SYSPRINT DD SY50UT=A 
//SYSIN DD * 
INSPECT UNITADDRESS(354) NOVERIFY TRACKS((2,3) (3,1) (1,3)) - 
RECLAIM 
/x 

INSPECTING A MINIDISK IN A STAND-ALONE ENVIRONMENT: EXAMPLE 5 

In this example, a mini 2314 that has already been initialized 
is inspected. It provides an unconditional assigment of an 
alternate track for tracks 5,1 and 5,2. Note that the parameter 
MIMICCMINK20) ) is specifying to Device Support Facilities that 
a minidisk is being inspected. If this parameter were not 
specified, the whole volume would be inspected and the alternate 
track would be assigned in the alternate track area of a full 
volume. 

INSPECT UNITADDRESSU50) NOVERIFY TRACKS( (5, 1 ) , (5,2) ) - 
DEVICETYPE(2314) MIMIC(MINI (20) ) NOCHECK 

INSPECTING A MINIDISK IN A STAND-ALONE ENVIRONMENT: EXAMPLE 6 

In this example, a mini 2314 that has already been initialized 
is inspected for defective tracks. It provides a surface 
analysis of the entire mini 2314 and a conditional assignment of 
alternate tracks for any tracks that are found defective. If any 
tracks that were flagged defective are found to be acceptable 
after the surface check, these tracks are reclaimed. The data is 
preserved on the volume. 

INSPECT UNITADDRESS(150) NOVERIFY ALLTRACKS - 

DEVICETYPE(2314) MIMIC(MINI (20) ) CHECK(l) - 
RECLAIM 
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INSPECTING A VOLUME TO RECLAIM TRACKS (DOS/VSE): EXAMPLE 7 

In this example, a volume previously initialized under DOS/VSE 
is inspected. Tracks previously flagged defective that are found 
to be acceptable are reclaimed. 

// JOB jobname 

// ASSGN SYS010,151 

// EXEC ICKDSF,SI2E=256K 

INSPECT SYSNAME(SYSOIO) NVFY TRKS((2,3) (3,1) (1,3)) - 

RECLAIM 
/x 
/& 

INSPECTING AN EMULATED PARTIAL DISK (DOS/VSE): EXAMPLE S 

In this example, all tracks of an emulated partial disk are 
inspected. Tracks previously flagged defective that are found, 
after the surface check, to be acceptable are reclaimed. 

// JOB jobname 

// ASSGN SYS020,353 

// EXEC ICKDSF,SIZE=256K 

INSPECT SYSNAMECSYS020) NVFY ALLTRKS - 

RECLAIM MIMIC(EMU(20)) 
/* 
/I 
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MAPALT: MAP ALTERNATE BLOCK ASSIGNMENTS 



Note: The MAPALT command is valid only in the DOS/VSE and 
stand-alone environments. 

The MAPALT command, for exclusive use on fixed block 
architecture (FBA) direct access storage devices, produces a 
printed report, or map, of the primary blocks that have been 
assigned to alternate blocks on the device. MAPALT parameters 
allow you to specify a limited range of primary blocks to be 
mapped or to specify that the entire volume be mapped. 

Execution of the MAPALT command is restricted to reading the 
identification fields of the primary blocks only. It is not 
necessary to create backup copies of the data on the volume 
before the command is invoked. Thus, the command may be executed 
against either a newly installed device or a device that already 
contains user data. 

The MAPALT command can only be executed against the device 
address that defines the entire device in fixed block mode. 
Emulated devices on fixed block devices are not supported. 

VM/370 users will be able to IPL the stand-alone version of 
Device Support Facilities to execute the MAPALT command against 
attached volumes. Users who IPL a DOS/VSE system under VM/370 
can execute the command against attached volumes by submitting 
batch jobs to their virtual machines. 



MAPALT REPORT OUTPUT 



A two-part report is produced. The first part, which may 
optionally be selected, is as shown below** 



PRIMARY 


BLOCK 
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BLOCK 


ADDRESS 




ADDRESS 


NUMBER 
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C = nnn 


H = nn 


C=nnn H=nn 



This is the detailed report that shows the relative block number 
of the defective primary block, its location on the volume 
(cylinder and head number), and the location of the alternate 
block which has been assigned to the primary block (also in 
cylinder and head number). 

The second portion of the report, which is always printed, is a 
summary message showing the number of blocks (within the 
specified range) found to have been assigned to alternates. 
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MAPALT DIAGNOSTIC OUTPUT 



I/O errors that cause interruption of program execution are 
reported by the program. The following information appears on 
the program output when such errors occur 1 

CSW = xxxxxx xxxxxx CCW = xxxxxxxx xxxxxxxx 
SENSE = xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx 
xxxxxxxx xxxxxxxx 

This information should be used, in accordance with installation 
procedures^ as an aid in isolating and correcting the cause of 
the problem. 

If a data check is encountered, an error message is printed 
giving the relative block number of the block causing the error, 
and then processing continues with the next sequential block. 



SYNTAX 



Command 


Required Parameters 


MAPALT 


UNITADDRESSCcuu)| 
SYSNAME(sysxxx) 


Optional Parameters 


LIMITS(lorbn,hirbn)|ALL 
DETAIL INODETAIL 



Note: DEVICETYPE is required for the stand-alone version 



UNITADDRESS 1 SYSNAME: IDENTIFYING THE DEVICE ON HHICH THE VOLUME IS MOUNTED 

Explanation: UNITADDRESS ( cuu ) I S YSNAME( svsxxx ) are required 
parameters identifying the volume that is to be mapped. 

UNITADDRESS 

Required when mapping a volume that is mounted offline or 
when mapping a volume in a stand-alone environment. 

For cuu , specify the hexadecimal address of the channel and 
unit on which the volume is mounted. 

Note: The device must be on a channel that is operational. 
If the device is on a channel that is not operational, the 
program may enter a nontermi nati ng wait state. 

SYSNAME 

Required when mapping a volume in the DOS/VSE environment. 
For svsxxx , specify the SYSNAME in the ASSGN control 

statement . 

Abbreviations: 

UNITADDRESS | UNITADDR | UNIT 
SYSNAMEISNAME 

Defaults- None. 

Restrictions: The SYSNAME parameter cannot be specified in a 
stand-alone environment. 
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LIMITS 1 ALL: SPECIFYING THE AREA TO BE MAPPED 

Explanation: LIMITSC lorbn, hi rbn) 1 ALL are optional parameters 
specifying the area of the disk where alternate block mapping is 
to be performed. 

LlMiTS(lorbn,hirbn) 

The value lorbn specifies the relative block number for the 
start of mapping. This value must be lower than* or equal 
to, the value specified by hi rbn . lorbn can be expressed as 
one to six decimal (n) or hexadecimal (X'n') characters. 

The value hi rbn specifies the relative block number for the 
end of mapping. This value must be lower than, or equal to, 
the highest relative block number on the device, hi rbn can 
be expressed as one to six decimal (n) or hexadecimal 
(X'n') characters. 

ALL 

Indicates that the entire volume is to be mapped. 

Abbreviations: 

LIMITS|LIMIT|LIMS|LIM 
Default: ALL 
Restrictions None. 

DETAIL INODETAIL: CONTROLLING THE PROGRAM OUTPUT 

Explanation: DETAIL I NODETAIL is an optional parameter that 
controls the amount of output from the program. 

DETAIL 

Causes printing of the detailed report that lists each 
defective block assigned to an alternate, gives its 
location on the disk, and gives the location of the 
assigned alternate block. 

NODETAIL 

Causes printing of the detailed report to be suppressed. 

Abbreviations: 

DETAILlDTL 
NODETAILINODTL 

Default: NODETAIL 

Restrictions: This parameter only controls printing of the 
detailed report and does not affect other output from the 
program. The summary message will be printed at all times upon 
termination of the program. 



EXAMPLES OF MAYS TO CODE THE MAPALT COMMAND 



The following examples illustrate ways you might code the MAPALT 
command in various situations. 
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MAPPIKG A VOLUME IN THE STAND-ALONE ENVIRONMENT: EXAMPLE 1 

In this example, a full volume scan of a 3310 direct access 
storage volume is performed and a summary report is made of the 
total number of blocks found that have alternates assigned. 

MAPALT UNITADDRESSC141) ALL NODETAIL 

Using abbreviations and defaults, you could have specified: 

MAPALT UNITC141) 

MAPPING A VOLUME IN THE STAND-ALONE ENVIRONMENT: EXAMPLE 2 

In this example, the range of blocks from 200,000 to 300,000 on 
a 3370 direct access storage volume is scanned. A detailed 
report is made of each block within that range that has an 
alternate assigned, and a summary report is made giving the 
total number of assigned alternates found. 

MAPALT UNITADDRESSC142) LIMITSC200000 ,300000 ) DETAIL 

Using abbreviations, you could have specified: 

MAPALT UNITADDRC142) LIM(200000, 300000 ) DTL 

MAPPING A VOLUME IN THE DOS/VSE ENVIRONMENT: EXAMPLE 3 

In this example, a full volume scan is performed on the fixed 
block architecture device assigned to SYS001. A detailed report 
is made of each block on the volume that has an alternate 
assigned, and a summary report is made giving the total number 
of alternates found. 

// JOB jobname 

// ASSGN SYS001,140 

// EXEC ICKDSF,SIZE=256K 

MAPALT SYSNAME(SYSOOl) ALL DETAIL 
/* 
/t 
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REFORMAT: REFORMATTING PORTIONS OF A PREVIOUSLY INITIALIZED VOLUME 



After a volume has been initialized, it can be reformatted to 
change the volume serial number, owner identification, and IPL 
bootstrap and program records. Only volumes that have been 
initialized can be reformatted. 

The abbreviation for the REFORMAT command is RFMT. 



SYNTAX 



Command 


Required Parameters 


REFORMAT 


UNITADDRESS(cuu) | 

DDNAME(dname)| 

SYSNAME(sysxxx) 
VERIFYCserial C, owner]) | 

NOVERIFY 


Optional Parameters 


PURGEINOPURGE 
VOLID(serial) 
OMMERIDC owner) 
IPLDDC (dnamel dlblname) 

COBJFORMATI ,ABSFORMAT]) 
BOOTSTRAP 1 NOBOOTSTRAP 



UNITADD RESSlPDNAMEtSYSNAME : 
MOUNTED 



IDENTIFYING THE DEVICE ON I4HICH THE VOLUME IS 



Explanation: UNITADDRESS ( cuu ) 1 DDNAME( dname ) I S YSNAHE( svsxxx ) are 

required parameters identifying the volume that is to be 
reformatted. 

UNITADDRESS 

Required when reformatting a volume that is mounted offline 
or when reformatting a volume in a stand-alone environment. 

For cuu , specify the address in hexadecimal of the channel 
and unit on which the volume is mounted. 

Note: The device must be mounted on a channel that is 
online. If the device is on a channel that is offline, the 
program might enter a nontermi nat i ng wait state. 

DDNAME 

Required when reformatting a volume that is mounted online. 
The device on which the volume is mounted must be online 
and the volume mounted as PRIVATE with DISP=0LD specified. 

For dname , specify the OS/VS JCL DD statement that 
identifies the device on which the volume is mounted. 



SYSNAME 

Required when reformatting a volume in the DOS/VSE 
environment. For sysxxx , specify the SYSNAME specified 
the ASSGN system control statement. 



l n 
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Abbreviations: 

UNITADDRESSIUNIT 
DDNAMElDNAME 

Defaults*- None. 

Restrictions: The UNITADDRESS parameter cannot be specified 
when reformatting a volume that is mounted online. 

The DDNAME parameter cannot be specified when reformatting a 
volume that is mounted offline or in a stand-alone environment 



VERIFY INOVERIFY: VERIFYING THE VOLUME SERIAL NUMBER AND OUNER IDENTIFICATION 

Explanation: VERIFY (serial C» owner] ) INOVERIFY are required 
parameters specifying whether to verify the volume serial number 
and owner identification before reformatting the volume. 

VERIFY 

Required when you want to verify the volume serial number 
and owner identification before reformatting the volume. If 
the volume serial number or owner identification does not 
match that found on the volume, the REFORMAT command 
termi nates. 

For serial , substitute one to six alphameric characters for 
the volume serial number. 

For owner , substitute one to fourteen alphameric characters 
for the owner identification. 

NOVERIFY 

Required when you want to bypass verification of the volume 
serial number and owner identification. 

Abbreviations: 

VERIFYlVFY 
NOVERIFY|NOVFY|NVFY 

Defaults: None. 

Restrictions: You cannot verify the owner identification 
separately from the volume serial number; both the volume serial 
number and the owner identification must be verified when you 
want to verify the owner identification. 

When you specify the VERIFY parameter and verification fails, 
execution of the command terminates. 



PURGEINOPURGE: 14RITING OVER USER VOLUME LABELS ON A PREVIOUSLY INITIALIZED 
VOLUME 

Explanation: PURGEI NOPURGE are optional parameters specifying 
whether existing user volume labels are to be written over by 
the specified IPL program. 

PURGE 

Indicates that you want to write over existing user volume 
labels during reformatting. 

NOPURGE 

Indicates that you do not want to write over any user 
volume labels. If a volume contains user volume labels and 
the IPLDD parameter is specified, the IPL program record is 
written following the last user volume label. 
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Abbreviations: 

PURGElPRG 
NOPURGElNOPRGlNPRG 

Defaults: The default is NOPURGE. 

Restrictions: The PURGE parameter applies only when the IPLDD 
parameter is specified. 



VOLIP: SPECIFYING A NEU VOLUME SERIAL NUMBER 

Explanation: VOL ID (serial.) is an optional parameter specifying 
a new volume serial number to be written in the volume label. 

F° r seri al , substitute one to six alphameric characters for the 
new volume serial number. If fewer than six characters are 
specified, the serial number is lef t- justi f i ed and the remainder 
of the field is padded with blanks (X»40 f ). 

Abbreviations: None. 

Defaults: When you reformat a volume and do not specify the 
VOLID parameter, the old volume serial number remains unchanged. 

Restrictions: The catalog must be changed to reflect the new 
volume serial number for any cataloged data sets that reside on 
the reformatted volume. 



OUNERIP: SPECIFYING A NEW VOLUME-OWNER IDENTIFICATION 

Explanation: OWNERIDC owner) is an optional parameter specifying 
a new volume-owner identification to be written in the volume 
label. 

For owner , substitute one to fourteen alphameric characters for 
a new volume-owner identification in the volume label. 

Abbreviations-* 

OWNERIDIOWNER 

Defaults: When a volume is reformatted and a new owner 
identification is not specified, the old owner identification 
remains unchanged. 

Restrictions: None. 



IPLDD: WRITING A USER-SUPPLIED IPL PROGRAM ON THE VOLUME 

Explanation: IPLDDC { dname l dlblname }[,OBJFORMATl ,ABSF0RMAT3) is 
an optional parameter which allows you to supply an IPL program 
to replace an existing IPL program or add one to the volume. 

This parameter should not be used when reformatting a Mass 
Storage System staging pack. 

The IPLDD and BOOTSTRAP parameters are used to specify one of 
the following: 

• If you do not specify IPLDD, ICKDSF writes special bootstrap 
records that cause the processing unit to be placed in a 
WAIT state if the volume is specified during an attempt to 
load the system. 
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• If you specify IPLDD but do not specify BOOTSTRAP, ICKDSF 
supplies an IPL bootstrap which is written on the volume 
together with the IPL text you supply. 

• If you specify IPLDD and BOOTSTRAP, ICKDSF uses the IPL 
bootstrap and the IPL text you supply. If neccesary, ICKDSF 
updates the bootstrap records to allow for possible user 
labels. 

The maximum size permitted for the IPL program record depends 
upon the type of volume being reformatted. The maximum sizes 
allowed are'' 



Volume Type 


Maximum Bytes for IPL Program 


2305-1 


12,180 


2305-2 


13,616 


2311 


3,110 


2314 


6,514 


2319 


6,514 


3330 


12,117 


3330-11 


12,117 


3340 


7,286 


3344 


7,286 


3350 


17,902 


3375 


33,984 


3380 


44,958 



Also, the number of existing user volume labels can further 
limit the size allowed for the IPL program if you specify the 
NOPURGE parameter. If you supply an IPL program that exceeds the 
size allowed, you receive an error message but the reformatting 
cont i nues. 

For dname , substitute 1 to 8 alphameric characters for the DD 
statement identifying the data set that contains the IPL program 
you want written on the volume being reformatted. The IPL 
program can be specified within the OS/VS JCL input stream 
(SYSIN). If the IPL program is in the OS/VS JCL input stream, 
the data must be included immediately after the REFORMAT 
command. For reformatting in a stand-alone environment, the 
dname must be specified as SYSIN. 

For dlblname , substitute 1 to 7 alphameric characters. These 
represent the file name that appears in the DLBL statement and 
identify the file that contains the IPL program you want written 
on the volume being reformatted. The IPL program can be included 
in the DOS/VSE JCS input stream (SYSIN). It must then be 
included immediately after the REFORMAT command. 

OBJ FORMAT 

Specifies that IPL data is being supplied in object deck 
format, that is, cards will have one of the following 
strings of EBCDIC characters in columns 2 through 4: 

TXT 
RLD 

ESD 
END 
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Note that only cards with TXT will be processed. All others 
will be i gnored. 

OBJFORMAT may be abbreviated as OBJECT or OBJ. 

ABSFQRMAT 

Specifies that IPL data is being supplied in the form of 
variable-length records that contain executable 
instructions. When IPL data is supplied in this format, it 
is necessary to provide a minimum of three records. The 
maximum number of records supplied and their lengths are 
only limited by the track capacity of the volume on which 
these records are to be written. 

The first two records supplied must be the bootstrap 
records and are restricted to lengths of 24 and 144 bytes, 
respect i vely . 

The contents of the IPL records and the contents of the 
program are not checked by ICKDSF. It is the user's 
responsibility to ensure that the IPL records can load an 
executable program. The first IPL record must contain a PSW 
followed by two CCWs (channel command words). The CCWs 
should have the following hexadecimal formats 1 

First CCW 06xxxxxx 60000090 
Second CCW 08xxxxxx 00000000 

The first CCW is a command to read in the second IPL record 
at main storage address xxxxxx . The second CCW is a 
transfei — in-channel command (a branch) to the CCW that 
begins the second IPL record. 

The second IPL record must be 144 bytes long. Bytes 32 
through 42 (starting from byte zero) cannot be used. Bytes 
32 through 42 are used by ICKDSF for the seek address 
(bytes 32-37) and the CCHHR (bytes 38-42) of the third IPL 
record. 

The third through nth records that are supplied are assumed 
to be IPL program records and will be written on the volume 
without any modification after the standard volume label 
and any existing user volume labels. Note that the IPL 
program will only be written on the first track of the 
pack. If the records supplied exceed in length the 
remaining space on the first track, the function will 
terminate with an error message. 

ABSFORMAT may be abbreviated as ABSOLUTE or ABS. 

Abbreviations-- 

IPLDDlIPL 

Defaults : If you specify the IPLDD parameter without specifying 
the BOOTSTRAP parameter, the IPL bootstrap records necessary to 
transfer control to the IPL program record will be generated 
automatically. 

Restrictions: In a stand-alone environment, you must substitute 
SYSIN for the dname . 

When an IPL program is included in the SYSIN stream, it must 
immediately follow the REFORMAT command and be terminated by an 
ENDIPLTEXT card. The ENDIPLTEXT card is optional when the IPL 
program is in a data set other than the one specified by SYSIN, 
or when the end-of-file indicator (/*) immediately follows the 
data for the IPL program. 
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BOOTSTRAP I NOBOOTSTRAP: HRITING IPL BOOTSTRAP RECORDS ON THE VOLUME 

Explanation* BOOTSTRAP 1 NOBOOTSTRAP are optional parameters 
specifying whether you are supplying the IPL bootstrap records 
that are to be written on the volume during reformatting. 

BOOTSTRAP 

Indicates that you are supplying the IPL bootstrap records 
that are written on the volume during reformatting. These 
records must be the first four records in the IPL program 
text. The first text record must have IPL1 in the first 
four columns* followed by 24 bytes of data. The 24 bytes of 
data have the same format as the first IPL record described 
above under ABSFORMAT. The next three text records must 
have IPL2 in their first four columns, followed by 68 bytes 
of data each in the second and third records and 8 bytes of 
data in the last record. The 144 bytes of data have the 
same format as IPL record 2 described above under 
ABSFORMAT. 

NOBOOTSTRAP 

Indicates that you are not supplying IPL bootstrap records 
and require that the necessary IPL bootstrap records be 
generated by the Device Support Facilities program. 

Abbreviations^ 

BOOTSTRAPlBOOT 
NOBOOTSTRAP | N0B00T | NBOOT 

Defaults'- The default is NOBOOTSTRAP. 

Restrictions: The BOOTSTRAP and NOBOOTSTRAP parameters apply 
only when the IPLDD parameter is specified. This parameter is 
ignored when the IPL program is supplied in absolute format. 



EXAMPLES OF UAYS TO CODE THE REFORMAT COMMAND 

The following examples show different ways to code the REFORMAT 

command in offline and online mode (OS/VS) and for DOS/VSE. To 

eformat a volume in a stand-alone environment, take an example 

iven for OS/VS and do the following: 

Eliminate the OS/VS JCL. 

Substitute the UNITADDRESS parameter for the DDNAME 
parameter. 

Specify the DEVICETYPE parameter. 

Substitute SYSIN for dname in the IPLDD parameter. 

Note: Any values specified here are examples only and should not 
be interpreted as the values for your system. 

REFORMATTING A VOLUME TO CHANGE THE VOLUME SERIAL NUMBER IN OFFLINE MODE 
(OS/VS): EXAMPLE 1 

In this example, the volume serial number is being changed. Any 
catalogs that identify the volume by its old volume serial 
number must be modified. The VERIFY parameter is specified to 
ensure that the correct volume is being accessed before the 
volume serial number is changed. 
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REFORMAT 



//EXAMPLE1 JOB 
// EXEC PGM=ICKDSF 

//SYSPRINT DD SYSOUT=A 
//SYSIN DD * 
REFORMAT UNITADDRESSC 353) VERIFYCOLDVOL) - 
VOLIDCNEWVOL) 
/x 

REFORMATTING A VOLUME TO ADD AN IPL PROGRAM IN ONLINE MODE (OS/VS): EXAMPLE 2 

In this example* an IPL program is added to the volume, and the 
owner identification is changed. If any user volume labels exist 
on the volume, the IPL program is written over them because the 
PURGE parameter is specified. The Device Support Facilities 
program will supply the appropriate IPL bootstrap records. 



//EXAMPLE2 JOB 
// EXEC 

//IPLDECK DD 



PGM=ICKDSF 
X 



//VOLUMEL DD UNIT=3330 , DISP=0LD, V0L=SER=V0L123 
//SYSPRINT DD SYS0UT=A 
//SYSIN DD x 
REFORMAT DDNAME( VOLUMEL) IPLDDC IPLDECK) - 
OWNERID(BROWN) PURGE NOVERIFY 
/* 

REFORMATTING A VOLUME TO CHANGE THE VOLUME SERIAL NUMBER (DOS/VSE): EXAMPLE 3 

In this example, the volume serial number is verified and a new 
volume serial number is assigned. 

// JOB jobname 

// ASSGN SYS010,151 

// EXEC ICKDSF,SIZE=130K 

REFORMAT SYSNAME(SYSOIO) VERIFYCOLDVOL) VOLID(NEWVOL) 
/x 
/& 
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APPENDIX A. VOLUME LAYOUT AND RECORD FORMATS ON COUNT KEY DATA DEVICES 



Figure 8 shows the general layout of a disk pack in count key 
data format, from the lowest-numbered cylinder and track through 
the highest-numbered cylinder and track. 



Cylinder 0:0 Track 




Figure 8. General Volume Layout (Count Key Data Devices) 



Figure 9 on page 83 shows that, immediately after its index 
point, each track on a count key data device begins with a home 
address that describes the track type and condition. The home 
address is followed by a record that links defective primary 
tracks with their associated alternate tracks. After the home 
address and record 0, there are zero or more keyed or nonkeyed 
user-written records. (The 2305 Fixed Head Storage Models 1 and 
2 do not have home address records.) 
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Record-2 



Record-1 




Count/\ Record - n 
Key/ 
Data-n 



Figure 9. Standard Track Layout (Count Key Data Devices) 



Figure 10 shows an example of the volume map that can be 
received after processing a volume with Device Support 
Facilities with either the INIT or INSPECT command. 



ICKDSF DEVICE SUPPORT FACILITIES TIME: 09:14:01 05/17/78 PAGE 1 
INIT DDNAME(INPUT) PURGE CHECKC1) VT0C( , 10 , 10) VOLIDCNEWVOL) NOVERIFY 



ICK01307I DEFECTIVE-TRACK LIST IN HEXADECIMAL FOR VOLUME NEWVOL 

ICK01308I THE FOLLOWING PRIMARY TRACKS WERE FOUND DEFECTIVE: 

CCHH OF TRACK — CCHH OF ALTERNATE — FLAGGED DEFECTIVE — TRACK CONDITION 

00D4 0008 0328 0000 YES DEFECTIVE 

00DB 0008 0328 0001 YES DEFECTIVE 

0189 0000 0328 0002 YES DEFECTIVE 

018C 0011 0328 0003 YES DEFECTIVE 

020F 0005 0328 0004 YES DEFECTIVE 

0224 0O0D 0328 0005 YES NOT-DEFECTIVE 

027B 000E 0328 0006 YES DEFECTIVE 

02CE 0003 0328 0007 YES NOT-DEFECTIVE 

0307 000A 0328 0008 YES DEFECTIVE 



ICK01309I THE FOLLOWING ALTERNATE TRACKS WERE FOUND DEFECTIVE: 



CCHH OF TRACK — CCHH OF PRIMARY FLAGGED DEFECTIVE - 

032B 000D 032B 000D YES 



TRACK CONDITION 
DEFECTIVE 



ICK01313I VOLUME CONTAINS 133 ALTERNATE TRACKS -- 123 AVAILABLE. 
ICK01314I VTOC IS LOCATED AT CCHH=X*0000 OO0A' AND IS 10 TRACKS. 
ICK00001I FUNCTION COMPLETED. HIGHEST CONDITION CODE WAS 

Figure 10. Volume Map Output (Count Key Data Devices) 
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Legend for the volume map' 

1. Message ICK01307I is the first line of the volume mapj it 
identifies the volume serial number for which the map is 
produced. 

2. Message ICK01308I is printed as the second line of the 
volume map when one or more defective primary tracks were 
found. 

Note : Only as a result of medial and maximal initialization 
will all defective tracks be listed in the volume map. 
Minimal initialization and the INSPECT command result in a 
list of only those tracks that were checked during execution 
of the respective command* namely, the alternate tracks and 
the individual tracks inspected, respectively. Some of the 
tracks listed may not be defective, because the list may 
include tracks that are marked defective because of 
unconditional assignment of alternate tracks. 

3. Four columns of information are provided 5 

CCHH OF TRACK: The hexadecimal track address of the 
defective primary track. 

CCHH OF ALTERNATE: The hexadecimal track address of the 
alternate track assigned to the primary track. If a primary 
track is marked defective but does not have an associated 
alternate track, this column contains the primary track 
address. 

FLAGGED DEFECTIVE: A YES indicates that the home address 
flag byte has its defective-track flag on; a NO indicates 
that the defective-track flag is off. 

TRACK CONDITION: This column is printed only if the CHECK 
parameter was specified with the command or i f an 
unrecoverable track was found. DEFECTIVE indicates that the 
track could not be read without a DATA CHECK occurring. 
NOT-DEFECTIVE indicates that the track could be read and 
written without difficulty. The NOT-DEFECTIVE condition 
appears only when the RECLAIM parameter i s not specified, 
and indicates that the defective-track flag was on and, 
although the track did not appear to have defects, it was 
not reclaimed. UNRECOVERABLE indicates that surface checking 
could not be performed because I/O errors occurred, that 
prevented either the home address or the record from being 
written on the track. 

4. Message ICK01309I appears when one or more alternate tracks 
are found defective. The same information is provided for 
alternate tracks as is provided for primary tracks, but the 
second column identifies the primary track associated with 
the alternate track. 

Note* In some cases, the track address for the primary track 
is the same track address as that for the alternate track, 
which indicates that the alternate track is not associated 
with a primary track. When an alternate track is found 
unrecoverable, the "FLAGGED DEFECTIVE" column is blank, and 
the primary track address is set to NONE. 

5. Message ICK01313I indicates the number of alternate tracks 
defined for the volume and the number of alternate tracks 
that are neither defective nor assigned. 

6. Message ICK01314I identifies the track address where the 
volume table of contents begins and the number of tracks 
reserved for it. 
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Figure 11 shows the contents of cylinder 0, track after the 
volume has been initialized. The first track of the first 
cylinder is reserved for system-defined records 5 

Home address and record 

IPL bootstrap records 

Volume label 

Optional usei — volume labels 

Optional IPL program 




Figure 11. Cylinder 0, Track Layout (Count Key Data Devices) 



Figure 12 shows how the primary and alternate track associations 
are recorded on the volume. 



Primary Track 



Cylinder 



Track \fCCHH 
18 




Figure 12. Primary/Alternate Track Association (Count Key Data 
Devi ces) 
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Figure 13 shows the contents of the IPL bootstrap records as the 
system supplies them. Each bootstrap record has a count area and 
a 4-byte key area. The key of the first record is IPL1, and the 
count area indicates that its data arsa is 24 bytes long. The 
key of the second record is IPL2, and the count area indicates 
that its data area is 144 bytes long. Bootstrap record 1 causes 
bootstrap record 2 to be read, and bootstrap record 2 causes the 
IPL program to be read. The IPL program contains usei — defined 
values. 



IPL Bootstrap Record l: 

00000000 00000000 PSW 
06003A98 60000060 CCW: 
08003A98 00000000 CCW: 



Read 
TIC 



IPL Bootstrap Record 2: 

07003AB8 40000006 

31003ABE 40000005 

08003AA0 00000000 

06000000 20000000 

000000000000 

0000000004 

0000000000000000 

0000000000000000 

Figure 13. IPL Bootstrap Records 



CCW: 


Seek 


CCW: 


Search Id Equal 


CCW: 


TIC 


CCW: 


Read 


Seek 


Address — 00 


Search Address — R 4 


Padd 


i ng 


(101 


Bytes) 
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Figure 14 shows the format of the home address on each track. 
When a volume is initialized, the flags for each track are set 
as indicated in the figure. 

The skip-displacement bytes appear as part of the home address 
record on each track for 3340 direct access storage facility and 
3350 direct access storage devices only. The home address on 
each track for the other supported devices begins with the flag 
byte. 



r 
\ 



SD Bytes 




U 



Skip Disp 

Device 

33^ 

33E 

Flags 
1 : 


lacement 

depends 

K): 1 SD 

)0: 3 SD 

> 3 4 5 


B^ 
*nt 

By 

by 

e 


fles 

'te field 
te fields 

7 

I 








0: Primary 
1 : Alternate 








i racK ^onamon 
0: Non-defective 
1 : Defective 








Pack Mode 
0: Normal 
1 : CE Pack 



Figure 14. Standard Home Address Format (Count Key Data 
Devices) 
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Figure 15 shows the format of record 0. When a volume is 
initialized, the record is written immediately following the 
home address on each track. Record contains a flag byte, a 
track address, its key length, and its data length. The flag 
bits are set as indicated in the figure. 

The record on each primary track contains its own track 

address unless it has been assigned an alternate track. If the 

prima 

alter 

0. 



33 unx«33 i v. ncja uesn cissiyimu cm oiternaie iracn. it tne 
ry track has been assigned an alternate track, the assigned 
nate track address is written in the primary track's record 



The record on each alternate track contains its own track 
address unless it has been assigned to a primary track. If the 
alternate track has been assigned to a primary track, the 
assigned primary track address is written in the alternate 
track's record 0. 





Flags (Not transmitted) 
12 3 4 5 6 7 



Track Type 
0: Primary 
1: Alternate 

'Track Condition 
0: Non-defective 
1 : Defective 

Unused (Set Zero) 

■ Record Overflow 

0: Logical Record End 
1 : Logical Record continued 
on next track 

Unused (Set Zero) 



El Track Address of self-same track, or of associated Alternate or Primary (the 
R value is always zero) 

EJ Key-length Always zero (0) 

U Data-length Always eight (8) 

■3 Data-Area Always eight bytes: binary zeros when initialized by ICKDSF 

Figure 15. Standard Record Format (Count Key Data Devices) 
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APPENDIX B. MINIDISK SUPPORT 



This appendix explains only minidisk support. A VM/370 user is 
able to initialize or inspect either a real disk or a virtual 
disk (VM minidisk). Initialization of a partial disk as an OS 
minidisk in the VM/370 environment is available only in the 
stand-alone environment. The following devices are supported as 
mi ni di sks? 



2314, 2319, 2305-1, 2305-2, 3330, 3330-11, 3330V, 3340, 3344, 
3350, 3375, and 3380. 



2305/3330/3330V/3340/3350/3375/3380 DASD Devices 

The only level of initialization provided is minimal 
initialization. A volume label, VTOC, and, optionally, 
IPL records can be written. Alternate tracks are not 
provided. 



Pack inspection is not allowed on these devices, as 
writing of home-addresses and standard-length record 



zeros is inhibited on 
envi ronment . 

• 2314/2319 DASD Devices 

Minimal, medial, and maximal initialization are 
provided. The last cylinder of the 2314 minidisk is 
always reserved for use as an alternate track cylinder. 
Therefore, a 2314 minidisk will always have a minimum of 
2 cylinders. The initialization function uses the last 
cylinder of the minidisk as an alternate track cylinder. 

All the functions provided by the INSPECT command are 
available for a 2314/2319 minidisk. 

The parameter used to specify the number of cylinders in both 
the commands INIT and INSPECT for an OS minidisk in the VM 
envi ronment i s : 

MIMIC(MINKn)) 

where n = number of cylinders 

Note: For 2305/3330/3330V/3340/3350/3375/3380 devices, "n" 
determines the actual amount of space on that volume, that is, 
reflected in the VTOC's DSCB Format-4 record. For 2314, the last 
cylinder is always reserved as the alternate track cylinder. 
Therefore, only "n-1" cylinders are available as primary 
cylinders, that is, reflected in the VTOC's DSCB Format-4 
record. 
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APPENDIX C. DEVICE SUPPORT FACILITIES MESSAGES (ICK) 



This appendix contains all Device Support Facilities messages 
with the ICK prefix. 

For ease of reference, you might want to remove this appendix 
from the publication and insert it in one of the following 
publ i cati ons = 

• VSE/Advanced Function Messages * SC33-6098, if you use Device 
Support Facilities in a VSE environment 

• OS/VS Message Library: vsi System Messages , GC38-1001, if 
you use Device Support Facilities in a VSI environment 

• OS/VS Message Library? VS2 System Messages , GC38-1002, if 
you use Device Support Facilities in an MVS environment 



INTRODUCTION 



Messages are detailed as fully as possible to permit you to 
understand a condition and to take necessary action. Information 
for each message includes, when appropriate: 

• Explanation : What the message means, why it appears, what 
caused it, what its variable fields are. 

• System Acti on : What is happening as a result of the 
condition causing the message. For example, is the system 
waiting for responses. 

• Operator and/or Programmer Response : If a response is 
necessary, who performs it, what the pertinent responses 
ars, and their effect on the system or program. 

• Problem Determination : If the problem recurs or is 
persistent to the point that system efficiency suffers, what 
actions can be performed to obtain adequate data for trained 
hardware or programming support personnel to diagnose the 
problem. 

The last item, problem determination, will often refer to the 
tabular listing of problem determination actions in Appendix D. 
These common action tables do not teach diagnostic techniques, 
but instruct the operator or programmer what to do when problems 
recur. The problem determination actions are aids to identify 
hardware or programming problems and they ensure that support 
personnel have the essential programming information available 
to diagnose and correct the difficulty. 



MESSAGE ROUTING AND DESCRIPTOR CODES 



Routing codes provide the ability to route system operator 
messages to selected funtional areas. 

Device Support Facilities messages will be routed to default 



functional areas as defined by a specific 
the absence of such definition, they will 
master console. 



i nstallat j on 
be routed to 



or, 
the 



i n 



The descriptor codes will always indicate system status. 
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Component Name ICK 

Program Producing Message Device Support Facilities 

Audience and Where Produced For operator 1 the operator's console. For system 

programmer- printed output. 

Message Format ICK s nnnn t text or ICK nnn t text 

s 

Condition code indicating severity of message 
received at the output printer. Messages 
received at the console do not have a 
condition code indicating severity. 

Information^ no effect upon execution 

1 Warning' function might fail 

2 Error* function probably failed 

3 Serious Error* function failed 

4 Terminal error* Device Support 
Facilities processor terminated 

It is possible to determine which of several 
messages issued during execution of a command 
results in a specific condition code value" 
The highest condition code multiplied by four 
yields the command's setting of the LASTCC. 

nnnn or nnn 

Message serial number' four digits for printed 
messages, and three digits for messages that 
appear at the operator's console. 

t 

Type code* 

I Informational, no action required 
E Eventual action required 
D Decision required, processing waiting 
A Operator action required 



text 



Message text 

** Indicates a 'second-level' message that 
further explains a preceding message. The 
track addresses (cccc'hhhh) in message text 
appear in hexadecimal format. 



Associated Publications None 



Problem Determination If the problem recurs, perform the problem 

determination actions to ensure that qualified 
support personnel will have the essential 
programming information available to diagnose and 
correct the difficulty. Refer to Appendix D for 
problem determination instructions. 



Appendix C. Device Support Facilities Messages (ICK) 91 



MESSAGES RECEIVED AT THE CONSOLE 



ICK001D CONFIRM PURGING OF 

UNEXPIRED DATA SETS, REPLY 
U TO PURGE, ELSE T 

Explanation: Before processing 
starts, if one or more unexpired data 
sets have been found, the operator is 
requested to confirm that the volume 
contents may be destroyed. 

System Action: Device Support 
Facilities waits for the operator's 
response. 

Operator Response: Respond U to 
permit unconditional purging of the 
data set; or respond T to prohibit 
purging and to terminate the function 

Programmer Response: None. 

Problem Determination: Not 
appl i cable. 



ICK002D 



ERROR 
OR 'T 



IN REPLY, REPLY 'U 



Explanation: When replying to 
messages whose only acceptable 
response is U or T» the operator 
responded with another character. Any 
other character will cause this 
request for reentry to be made. 

System Action: Device Support 
Facilities waits for the operator's 
response. 

Operator Response: Respond with U for 
unconditional purging, or T to 
termi nate. 

Programmer Response: None. 

Problem Determination: Not 
applicable. 



ICK003D REPLY 'U' TO ALTER VOLUME 
CUU CONTENTS, ELSE 'T' 



Explanation: Whe 
volume cuu offlin 
requested to conf 
because the offli 
checked by the op 
data on the volum 
modified. Dependi 
parameter used, t 
little as the vol 
command with VOLI 
(INSPECT with NOP 
whole volume (INI 



n processing the 
e, the operator is 
i rm the processing 
ne volume i s not 
erating system, and 
e might be lost or 
ng on the command and 
his data might be as 
ume serial (REFORMAT 
D parameter), a track 
RESERVE), or the 
T with CHECK). 



System Action: Device Support 
Facilities waits for operator's reply. 



Operator Response: Respond U to 
proceed with command processing; 
respond T to terminate the command. 

Programmer Response: None. 

Problem Determination: Not 

applicable. 



ICK004D READY DEVICE CUU AND REPLY 
f U', ELSE »T» 

Explanation: The device cuu is not in 
the READY state. 

System Action: Device Support 
Facilities waits for the operator's 
response. 

Operator Response: Ensure that the 
device is in the READY state, and 
respond U to continue processing the 
command or respond T to terminate the 

command. 

Programmer Response: None. 

Problem Determination: Not 
appl i cable. 



ICK005E DEFINE INPUT DEVICE: 

'xxxx,cuu* or 'CONSOLE* 

Explanation: xxxx is the device type 
and cuu is the channel and unit 
address. This message appears only in 
a stand-alone environment. The 
operator must specify the device type 
and location of the command input 
stream. 

System Action: Device Support 
Facilities waits for the operator's 
response. 

Operator Response: Specify the input 
device type and its channel and unit 
address. 

Programmer Response: None. 

Problem Determination: Not 

applicable. 



ICK006E DEFINE OUTPUT DEVICE: 

'xxxx, cuu' or 'console' 

Explanation: xxxx is the device type 
and cuu is the channel and unit 
address. This message appears only in 
a stand-alone environment. The 
operator must specify the device type 
and the location of the printed 
output . 

System Action: Device Support 
Facilities waits for a reply. 

Operator Response: Specify the output 
device type and its channel and unit 
address. 
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Programmer Responses None. 

Problem Determination: Not 

appl i cable. 



ICK007E INVALID INPUT DEVICE 
SPECIFIED 

Explanation: This message appears 
only in a stand-alone environment. The 
operator specified an invalid device 
type to messageVl_CK0O5E. 

System Action: Device Support 
Facilities repeats message ICK005E. 

Operator Response: Specify a correct 
input device type. 

Programmer Response: None. 

Problem Determination: Table I, items 
2, 3, 4, and 29. 



ICK008E INVALID OUTPUT DEVICE 
SPECIFIED 

Explanation: This message appears 
only in a stand-alone environment. The 
operator specified an invalid device 
type to message ICK006E. 

System Action: Device Support 
Facilities repeats message ICK006E. 

Operator Response: Specify a correct 
output device type. 

Programmer Response: None. 

Problem Determination: Table I, items 
2, 3, 4, and 29. 



ICK009I 



SVC INTERRUPT OCCURRED 



Explanation: This message appears 
only in a stand-alone environment. 
Probable program error. The SVC 
instruction cannot be used in a 
stand-alone environment. 

System Action: Device Support 
Facilities terminates. 

Operator Response: Notify the system 
programmer. 

Programmer Response: See Problem 
Determi nati on. 

Problem Determination: Table I, items 
2, 3, 4, and 29. 



ICK010I 



PROGRAM INTERRUPT OCCURRED 



Explanation: This message appears 
only in a stand-alone environment. 
Probable program error. An instruction 
executed incorrectly. 



System Action: Device Support 
Facilities terminates. 

Operator Response: Notify the system 

programmer. 

Programmer Response: See Problem 
Determi nati on . 

Problem Determination: Table I, items 
2, 3, 4, and 29. 



ICK011E I/O ERROR — error-type, 
cuu, command, csw, sense 

Explanation: This message appears 
only in a stand-alone environment. An 
I/O error of the type indicated 
occurred on the device at address cuu. 
The command in error is indicated as 
are the contents of the channel status 
word (CSW) and the results of a sense 
operation against the device. 

System Action: Device Support 
Facilities terminates. 

Operator Response: None. 

Programmer Response: Correct the 
cause of the error, and restart Device 
Support Facilities. 

Problem Determination: Table I, items 
2, 3, 4, and 29. 



ICK012E INTERVENTION REQUIRED, CUU 

Explanation: This message appears 
only in a stand-alone environment. The 
indicated device is not in the READY 
state. 

System Action: Device Support 
Facilities waits for correction of the 
problem. 

Operator Response: Ensure that the 
device is in a READY state. 

Programmer Response: None. 

Problem Determination: Not 
appl i cable. 



ICK013E 



CONSOLE READ FAILED, 
REENTER LAST LINE 



Explanation: This message appears 
only in a stand-alone environment. An 
I/O error occurred when attempting to 
read a line that was entered at the 
operator's console. 

System Action: Device Support 
Facilities waits for the line to be 
reentered. 

Operator Response: Reenter the line. 
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Programmer Response: 

Problem Determination: 

2, 3, 4, and 29. 



None. 

Table I, items 



ICK014D SET DEVICE CUU IN 

WRITE-MODE AND REPLY 'IT, 
ELSE f T' 

Explanation: The device at address 
cuu is set in read-only mode. 

System Action: Device Support 
Facilities waits for operator's 
response. 

Operator Response: Set the device to 
allow write operations and reply U. If 
write operations cannot be allowed, 
reply T, and the command terminates. 

Programmer Response: None. 



Problem Determination: 

appl i cable. 



Not 



Operator Response: Respond by 
specifying the hour, minute, and 

second if you want the time of day to 

appear in the title line of the output 

listing. If you do not want it to 

appear, respond by pressing the ENTER 
key. 

Programmer Response: None. 

Problem Determination: Not 

appli cable. 



ICK017D 



filename IS A SECURED FILE 



Explanation: The specified 'filename' 
is a data-secured file and Device 
Support Facilities requests permission 
to purge this file in an associated 
message, ICK018D. 



System Action: 
as the message 



Processing continues, 
is informational only. 



Operator Response: None 



ICK015E TODAY'S DATE, REPLY 
f mm/dd/yy* 

Explanation: This message appears 
only in a stand-alone environment. If 
you want the date to appear as part of 
the output title line, respond with 
the month, day, and year as indicated; 
otherwise, press the ENTER key. 

System Action: The date appears in 
the title line of the output listing, 
or blanks are substituted if a date 
was not supplied. 

Operator Response: Respond with the 
month, day, and year if you want the 
date to appear in the title line of 
the output listing. If you do not want 
the date, respond by pressing the 
ENTER key. 

Programmer Response: None. 

Problem Determination: Not 
appl i cable. 



ICK016E 



SUPPLY TIME OF DAY, REPLY 

'hh:mm:ss* 



Explanation: This message appears 
only in a stand-alone environment. If 
you want the time of day to appear in 
the title line of the output listing, 
respond with the hour, minute, and 
second as indicated; otherwise, 
respond by pressing the ENTER key. 

System Action: The time of day 
appears in the title line of the 
output listing, or blanks arG 
substituted if a time of day was not 
speci f i ed. 



ICK018D CONFIRM PURGING OF 

SPECIFIED FILE NAME, REPLY 
U TO PURGE, ELSE T 

Explanation: The filename is 
displayed in message ICK017D and 
permission is being requested to purge 
the filename specified in message 
ICK017D. 

System Action: Processing continues 
after the correct reply is obtained 
from the operator. If the operator 
replies T, the command terminates and 
Device Support Facilities continues 
processing with the next command. If 
the operator replies U, processing of 
the command continues. 

Operator Response: The operator must 
reply to this message with either U or 
T. 

Programmer Response: None. 



ICK019D CONFIRM PURGING OF ALL VSAM 
FILES, REPLY U TO PURGE, 
ELSE T 



Explanation: 

requested to 



Permission is being 
purge all VSAM files in 
the DOS/VSE environment. Note that 
this message is issued once only (upon 
discovery of the first VSAM file on 
the volume) . 

System Action: Processing continues 
after the correct reply is obtained 
from the operator. If the operator 
replies T, the command terminates and 
Device Support Facilities continues 
processing with the next command. If 
the operator replies U, processing of 
the command continues. 
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Operator Response: The operator must 
reply to this message with either U or 
T. 

Programmer Response: None. 



Programmer Response: None, 



ICK020D 



DEVICE CUU IS SHARED. REPLY 
U OR T 



Explanation: The volume addressed by 
the "cuu" is being shared, and Device 
Support Facilites requests permission 
to operate on the subject volume. 

System Action: Processing continues 
after the correct reply is obtained 
from the operator. If the operator 
replies T, the command terminates and 
Device Support Facilities continues 
processing with the next command. If 
the operator replies U , processing of 
the command continues. 

Operator Response: The operator must 
reply to this message with either U or 
T. 

Programmer Response: None. 



ICK057I INVALID DEVICE TYPE: VTOC 
INDEX NOT SUPPORTED ON THIS 
DEVICE 

Explanation: The device type is not a 
valid device type for initialization 
with a VTOC index. 

System Action: The creation of the 
VTOC index is not attempted. INIT 
command processing continues. 

Operator Response: None. 

Programmer Response: None. 



ICK058I CUU I/O ERROR DETECTED 
DURING INDEX CREATION: 
ERROR CODE= X 

Explanation: An I/O error occurred 
during VTOC index creation processing. 
Error codes* 

1 - Error occurred reading volume 

label 

2 - Error occurred reading VTOC 

3 - Error occurred writing VTOC 

4 - Error occurred writing index 

records 

5 - Index extent violated; increase 

index size 

System Action: VTOC index creation 
processing is terminated. The DOS 
volume indicator is turned on in the 
VTOC. INIT command processing 
cont i nues. 

Operator Response: Refer the error 
indication to the system coordinator 
for problem determination. 



ICK059I 



INDEX STARTING LOCATION 
INVALID AS SPECIFIED 



Explanation: The INDEX parameter on 
the INIT command statement is invalid. 
The starting location, as specified, 
is not valid for one of the following 

reasons 1 

1. It caused an overlap with the 
VTOC. 

2. It defined cylinder zero, track 
zero as the starting location of 
the index data set. 

3. It was outside the physical limits 
of the device. 

4. The relative track specified is 
invalid for the device. 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: Check the values 
specified for the INDEX parameter and 
correct the value in error. Resubmit 
the job. 



ICK061I CUU VTOC INDEX CREATION 

SUCCESSFUL: VOLUME NOW IN 
INDEX FORMAT 

Explanation: The VTOC index was 
successfully created on the volume. 

System Action: None. 

Operator Response: None. 

Programmer Response: None. 

ICK062I CUU VTOC INDEX CREATION 
FAILED: RETURN CODE= 8 

Explanation: Index creation was 
unsuccessful . 

System Action: None. 

Operator Response: None. 

Programmer Response: Check the job 
output for additional information on 
the reason for job failure. 



ICK400I 



CUU ANALYZE STARTED 



Explanation: ANALYZE has started to 
execute its tests on the logical 
volume identified in the message (that 
is, on the volume whose unit address 
i s cuu) . 
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System Action* Processing continues. 
Operator Response: None 



ICK401I 



CUU SUSPECTED DRIVE PROBLEM 



Explanation: During the drive tests, 
ANALYZE detected an error. During the 
data verification test, ANALYZE 
detected an error other than data 
check . 

System Action: ANALYZE -processing 
terminates, and message ICK406I 
(ICKQ1406I) is issued. 

Operator Response: Depending on your 
installation's procedures, you might 
do the following^ 

• Restore the entire volume to 
another drive from a backup 
volume. 

• Discontinue using the drive. 

Save the console output and ANALYZE's 
printer output, which contain further 
information about the hardware 
problems. 

Take the action appropriate to your 
installation's procedures for handling 
suspected equipment problems. If the 
problem recurs, contact your IBM 
Customer Engineer or Service 
Representati ve. 



ICK402I 



CUU ERROR READING DATA 



Explanation: ANALYZE detected data 
checks while reading data. This 
message is followed on the printer by 
a message that identifies the track 
and cylinder number on which each data 
check occurred. The cause of the 
problem could be a damaged disk 
surface or an intermittent read/write 
circuitry failure. 

System Action: ANALYZE processing 
terminates, and message ICK406I 
(ICK01406I) is issued. 

Operator Response: Depending on your 
installation's procedures, you might 
do one of the following: 

• Restore the entire volume from a 
backup volume. 

• Rebuild the track that has the 
error. 

• Assign an alternate track and then 
restore the track. 

• Rebuild the data set. 



Save the console output and ANALYZE's 
printer output, which contain further 
i nf ormat i on. 



Problem Determination: 
1, 2, 3, 4, 30. 



Table I, items 



ICK403I 



CUU DATA SCAN VALUES 
INVALID, TESTING TERMINATED 



Explanation: The relative block 
number(s), tracks, or cylinders 
specified by the LIMITS parameter are 
i nval i d. 



System Action: 
not done. 



Data verification is 



Operator Response: Specify valid 
relative block number(s), tracks, or 
cylinders in the LIMITS parameter and 
resubmit the request. 



ICK404I 



CUU VOLUME HAS UNFORMATTED 
DATA BLOCKS 



Explanation: An attempt was made to 
read a data block which was not 
initialized (data field not written). 

System Action: After 504 data checks, 
the ANALYZE command is terminated. 

Operator Response: Perform 
appropriate procedures to recover all 
desired data from the volume and then 
run the DOS utilities INTDK or INTDSK 
with the 'IQ' option to initialize all 
data blocks. 



ICK405I CUU ALL DATA 'MACHINE 

READABLE' WITHOUT ERRORS 



Explanation: The 
successfully read 
verification test 



volume was 
during the data 
(SCAN option). 



System Action: ANALYZE processing 
terminates normally, and message 
ICK406I (ICK01406I) is issued. 

Operator Response: None. (If a data 
problem prompted you to run ANALYZE, 
and if the problem persists, further 
analysis is needed according to your 
installation's procedures.) 



ICK406I 



CUU ANALYZE ENDED 



Explanation: ANALYZE has completed 
processi ng. 

System Action: ANALYZE processing 
termi nates. 

Operator Response: None. 
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ICK407I 



CUU NO DRIVE PROBLEMS FOUND 



Explanation: ANALYZE successfully 
completed executing the drive tests 
and did not detect any problems. 

System Action: If the SCAN option was 
specified or defaulted, ANALYZE 
processing continues with the data 
verification test. Otherwise, ANALYZE 
processing terminates, and message 
ICK406I (ICK01406I) is issued. 

Operator Response: None. (If a data 
problem prompted you to run ANALYZE, 
and if the problem persists, run the 
data verification test. If a drive 
problem prompted you to run ANALYZE, 
and if the problem persists, further 
analysis is needed according to your 
installation's procedures.) 



ICK408I 



CUU DATA VERIFICATION TEST 
STARTED 



Explanation: ANALYZE has started to 
execute its data verification tests. 

System Action: Processing continues. 

Operator Response: None. 



ICK412I 



DEVICE NOT READY, TESTING 
TERMINATED 



Explanation: A condition occurred 
which caused "Intervention Required" 
to be posted in the failing CSW sense 
byte. 



System Action: 

termi nated. 



The ANALYZE command is 



Operator Response: Ready the drive, 
and reissue the command. 



ICK413I 



DATA FORMAT UNACCEPTABLE, 
TESTING TERMINATED 



Explanation: Data on the cylinder is 
written in a format other than the IBM 
standard format, or an intermittent 
drive error occurred during the data 
verification test, or the volume under 
test was accessed by another program 
that erased an EOD record after it was 
read by the data verification test and 
before it was reread by the test. 



System Action: 

termi nated. 



ANALYZE processing is 



Operator Response: None. 



ICK410I 



MAIN STORAGE NOT AVAILABLE, 
TESTING TERMINATED 



ICK41«I 



WRITE INHIBIT SWITCH ON, 
WRITE TESTS BYPASSED 



Explanation: Dynamic acquisition of 
storage for work areas and control 
blocks failed. 

System Action: ANALYZE command 
processing is terminated. 

Operator Response: Increase main 
storage size. 



ICK411I INCORRECT DEVICE TYPE, 
TESTING TERMINATED 

Explanation: The device type 
specified for the ANALYZE volume is 
not supported by ANALYZE. 

System Action: ANALYZE processing is 
termi nated. 

Operator Response: Specify the 
correct device type in the DEVICETYPE 
keyword of the ANALYZE command and 
execute ANALYZE again. Valid device 
types are 3310, 3344, 3350 (including 
3330 and 3330-11 emulations) and 3370, 



Explanation: An error is detected 
when ANALYZE attempts to write a 
record and fails because the "R/W" or 
"READ" switch is in the "READ" 
position, or the "READ/WRITE" switch 
position is defective. 

System Action: All tests that attempt 
to write on the CE cylinder are 
bypassed. 

Operator Response: Set the 
"READ/WRITE" switch in "WRITE" mode. 



ICK415I 



INVALID UNITADDRESS, 
SYSNAME OR DDNAME SPECIFIED 



Explanation: The channel and unit 
addresses specified do not exist in 
the system I/O configuration, or the 
DDNAME is incorrect, or the SYSNAME is 
i ncorrect . 

System Action: ANALYZE command 
processing is terminated. 

Operator Response: Correct the values 
specified for "cuu" in the UNITADDRESS 
parameter, or correct the DDNAME 
specified, or correct the SYSNAME 
specified, then reissue the command. 
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ICK416I 



UNABLE TO OPEN VOLUME 



Explanation: The volume that was 
specified cannot be OPENed. The DD 
statement could be missing or invalid, 
or the channel and unit address could 
be i nval id. 

System Action: The ANALYZE command is 
terminated. 

Operator Response: Correct the error, 
and reissue the command. 



ICK417I 



WRITE TESTS BYPASSED 



Explanation: A bad home address on 
the CE cylinder was detected while 
trying to verify positioning of the 
access mechanism. 

System Action: All wri te-dependent 
tests are bypassed. 

Operator Response: None. 

Problem Determination: Table I, items 
2, 3, 4, 30. 



ICK501I INVALID DEVICE TYPE 

SPECIFIED FOR BUILDIX 
COMMAND 

Explanation: A request was made to 
change the format of a VTOC on a 
volume whose device type is not 
supported by the BUILDIX command (for 
example, a 2314 DASD). 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 



ICK502I 



BUILDIX FUNCTION STARTED 



Explanation: Execution of the BUILDIX 
command has begun. 

System Action: None. 
Operator Response: None. 



ICK503I 



CUU REQUEST RECEIVED TO 
CONVERT VTOC TO *XFORMAT 



Explanation: This message verifies 
the request for a change of VTOC 
format. '**' specifies the format 
requested — either OS or IX. 

System Action: Execution of the 
command continues. 

Operator Response: None. 



ICK504I CUU VTOC FORMAT IS 

CURRENTLY **FORMAT, REQUEST 
ACCEPTED 



Explanation: This message verifies 
that the BUILDIX function specified on 
the command statement is valid for the 
current format of the VTOC on the 
volume, '*** identifies the format of 
the VTOC, either OS or IX. 

System Action: Execution of the 
command continues. 

Operator Response: None. 



ICK505I CUU VTOC FORMAT IS 

CURRENTLY *XFORMAT, REQUEST 
REJECTED 

Explanation: The format of the VTOC 
is currently the same as the format 
requested in the BUILDIX command 
statement. '**' identifies the format 
of the VTOC, either OS or IX. 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 



ICK508A CUU SHOULD VTOC CONVERSION 
PROCEED? REPLY "U" TO 
CONTINUE, ELSE "C" 

Explanation: This message permits the 
operator to verify that the user is 
authorized to request the BUILDIX 
function before execution of the 
command begins. 

System Action: The system will wait 
for the operator's reply. 

Operator Response: Verify that the 
user is authorized to issue the 
command, and reply 'U' to continue. 
Any reply other than 'U' will be 
interpreted as a cancellation request. 



ICK509I 



CUU DIRF FLAG SET IN VTOC, 
BUILDIX CANNOT PROCEED 



Explanation: An error occurred during 
VTOC processing on a previous job, 
causing the DADSM interrupt flag to be 
set in the VTOC. The VTOC is not 
accurate. 

System Action: Execution of the 
command is terminated. 

Operator Response: Prepare a job that 
will cause reconstruction of the VTOC 
and run it against the volume. (For 
example, run an IEFBR14 job to 
allocate a temporary data set to the 
volume.) On conclusion of this job, 
resubmit the BUILDIX command. 



ICK510I CUU BUILDIX REQUEST 

CANCELLED DUE TO OPERATOR 
ACTION 
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Explanation: The operator replied 
'CANCEL' to a message requiring a 
response. 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 



Explanation: The BUILDIX command 
completed successfully. '**' shows the 
new VTOC format* either OS or IX. 

System Action: Device Support 
Facilities is terminated normally. 

Operator Response: None. 



ICK511I cuu CVAF ERROR: RETURN 

CODE=XX ERROR CONDITIONS 
XXX 

Explanation: The common VTOC access 
facility returned to Device Support 
Facilities with a return code 
indicating either a logical error or a 
physical error. Return codes have the 
following meanings 5 



4, 12 



Indicate logical errors 



ICK514I INDEXED VTOC FACILITY NOT 
ON SYSTEM. BUILDIX 
TERMINATED. 

Explanation: A request was made to 
change a VTOC to IXVTOC format, but 
the system does not contain indexed 
VTOC programming support. 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 



16 



Indicates an invalid index 
structure 



Indicates an I/O error 



The error condition will be printed 
only for a return code of 4 or 8. See 
Appendix B of Data Faci 1 i ty Devi ce 
Support* User's Guide and Reference 
for more information on these error 
condi t i ons. 

System Action: Execution of the 
command terminates with the following 
conditions existing, depending on the 
return code : 

4, 8, 12 

The volume is left in OSVTOC 
format . 



16 



The volume is left as it was 
before the command was i ssued. 



Operator Response: None. 



ICK512I cuu ERROR: SYS1.VT0CIX. IS 
A VIO DATASET. BUILDIX 
TERMINATED. 

Explanation: The index data set was 
allocated as a VIO data set and is not 
supported by the BUILDIX command. 

System Action: Execution of the 
command terminates with a return code 
of 12. The VTOC is left unchanged. 

Operator Response: None. 



ICK513I CUU BUILDIX PROCESSING 

COMPLETED: VTOC IS NOW IN 
XXFORMAT. 



ICK515I CUU BUILDIX COMMAND FAILED. 
RETURN CODE= 8 

Explanation: An error occurred that 
caused execution of the command to be 
terminated. 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 



ICK516I cuu I/O ERROR DETECTED 
DURING VTOC CONVERSION: 
ERROR CODE= X 

Explanation: An I/O error occurred 
during BUILDIX processing. Error 
codes : 

1 - Error occurred in reading the 

volume label 

2 - Error occurred in reading the 

VTOC 

3 - Error occurred in writing the 

VTOC 

4 - Error occurred in writing 

index records 

5 - Index extent was violated; 

increase index size 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: Refer the error 
indication to the system coordinator 
for problem determination. 



ICK517I 



CUU ERROR: VOLUME IS A DOS 
STACKED PACK 



Explanation: The volume being 
processed has a VTOC on the first 
track of the volume. VTOC conversion 
is not possible on such a volume. 
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System Action: Execution of the 
command is terminated. 

Operator Response: None. 



ICK524I 



UNABLE TO OPEN VOLUME 



ICK518I 



CUU ERROR: VOLUME CONTAINS 
SPLIT CYLINDER EXTENTS 



Explanation: It was found that the 
volume contains one or more shared 
extent data sets. These are not 
supported by the BUILDIX command. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: None. 



ICK519I CUU ERROR: SYSl.VTOCIX. 

DATASET NOT FOUND ON VOLUME 

Explanation: The index data set could 
not be found on the volume. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: None. 



ICK520I CUU ERROR: DUPLICATE INDEX 
DATASET NAME FOUND ON 
VOLUME 

Explanation: Two data sets were found 
on the volume that had names beginning 
with SYSl.VTOCIX. Only one per volume 
i s allowed. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: None. 



ICK521I 



CUU ERROR: INDEX DATASET 
EXTENT NOT CONTIGUOUS 



Explanation: The index data set was 
found to occupy more than one extent. 
This data set must occupy one, and 
only one, extent. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: None. 



ICK522I 



INVALID DDNAME SPECIFIED 



Explanation: The DDname is incorrect 
in the command statement. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: Correct the job 
control statement and resubmit the 
job. 



Explanation: The volume specified 
cannot be opened. The DD statement 
could be missing or invalid. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: Correct the error, 
and resubmit the job. 



ICK600I 



MAPALT STARTED 



Explanation: Execution has started 
for the MAPALT command. 

System Action: None. 

Operator Response: None. 



ICK602I 



INCORRECT DEVICETYPE, 
MAPALT TERMINATED 



Explanation: The device type 
specified is not supported by the 
MAPALT command. 

System Action: Execution of the 
MAPALT command is terminated. 

Operator Response: Specify the 
correct device type in the DEVICETYPE 
keyword of the command statement, and 
resubmit the job. MAPALT can only be 
executed on fixed block devices in 
fixed block mode. 

Programmer Response: None. 



ICK603I 



UNABLE TO OPEN VOLUME 



Explanation: The volume that was 
specified cannot be opened. The ASSGN 
statement could be missing or invalid, 
or the channel and unit address could 
be invalid. 

System Action: Execution of the 
MAPALT command is terminated. 

Operator Response: Correct the error 
and resubmit the job. 

Programmer Response: None. 



ICK604I CUU LIMITS PARAMETER 
INVALID AS SPECIFIED, 
MAPALT TERMINATED 

Explanation: The relative block 
numbers(s) specified by the LIMITS 
parameter are invalid. 

System Action: Execution of the 
MAPALT command is terminated. 



100 Device Support Facilities User's Guide and Reference 



Operator Response: Correct the 
value(s) in the LIMITS parameter, and 
resubmit the job. 

Programmer Response: None. 



ICK605I CUU UNRECOVERABLE I/O ERROR 
DETECTED, MAPALT TERMINATED 

Explanation: An unrecoverable I/O 
error (other than a data check) was 
encountered. 

System Action: Execution of the 
MAPALT command is terminated. 



Operator Response: 

output, which will 
information to aid 
error. Execute the 
Facilities ANALYZE 



Check the job 
contain diagnostic 
in analyzing the 
Device Support 
command as a 



problem determination aid, and follow 
installation procedures for recovery 
from this type of error. 

Programmer Response: None 



ICK606I nnnnn BLOCKS ASSIGNED TO 
ALTERNATES IN LIMITS 
SPECIFIED 

Explanation: This summary message 
shows the number of blocks that were 
assigned to alternates within the 
limits specified on the command 
statement. 

System Action: None. 

Operator Response: None. 

Programmer Response: None. 



ICK607I CUU MAPALT ABNORMALLY 
ENDED, REPORT MAY BE 
INCOMPLETE 

Explanation: This message is printed 
after an error has been encountered 
that caused execution of the command 
to be terminated. The report may be 
i ncomplete. 

System Action: None. 

Operator Response: Check previous 
messages on job output, and follow 
installation procedures. 

Programmer Response: None. 



ICK608I CUU MAPALT ENDED NORMALLY, 
RETURN CODE= n 

Explanation: Execution of the command 
ended without any errors detected that 
would have caused termination of 
execution. A return code of or 4 



will be indicated in the message. A 
return code of means no errors were 
encountered. A return code of 4 means 
one or more recoverable errors were 
encountered. 

System Action: None. 

Operator Response: None. 

Programmer Response: None. 



ICK609I 



PERMANENT DATA CHECK FOUND 
reading ID for block nnnnnn 



Explanation: A permanent data check 
was encountered while attempting to 
read the ID field of the primary block 
shown in the message. 

System Action: Diagnostic information 
is printed on the output device, and 
execution of the command continues. 

Operator Response: None. 

Programmer Response: Save the job 
output for the system coordinator, and 
follow installation procedures for 
data recovery and/or assignment of an 
alternate block. 



ICK610I 



TEMPORARY DATA CHECK FOUND 
READING ID FOR BLOCK nnnnnn 



Explanation: A temporary data check 
while attempting to read the ID field 
of the primary block shown in the 
message. 

System Action: Diagnostic information 
is printed on the output device and 
execution of the command continues. 

Operator Response: None. 

Programmer Response: Save the job 
output for the system coordinator and 
follow installation procedures for 
logging and tracking temporary error 
condi t i ons. 



ICK611I MAIN STORAGE NOT AVAILABLE, 
MAPALT TERMINATED 

Explanation: Dynamic acquisition of 
storage for control blocks and work 
areas fai led. 

System Action: Execution of the 
MAPALT command is terminated. 

Operator Response: Increase main 
storage size, and resubmit the job. 

Programmer Response: None. 
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MESS AGES RECEIVED AT THE OUTPUT 
PRINTER 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK00206I 



ICK00001I 



FUNCTION COMPLETED, HIGHEST 
CONDITION CODE MAS nn 



IMPROPERLY PLACED COMMA HAS 
BEEN FOUND AND IGNORED 



Explanation! A command has been 
executed; the value n_n i s the last 
condition code (LASTCC) generated 
during execution of the command. 

Note: The LASTCC value is the highest 
condition code found in the messages 
printed during execution of the 

command. 

System Action: LASTCC is set to nn ; 
MAXCC is set to nn if nn is greater 
than the current value of MAXCC. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 
appli cable. 

ICK00002I ICKDSF PROCESSING COMPLETE. 
MAXIMUM CONDITION CODE WAS 

nn 

Explanation: This message is issued 
upon completion of a Device Support 
Facilities job step. The highest 
condition code (MAXCC) set during the 
job step is printed (see message 
ICK00001I) and returned to the Device 
Support Facilities invoker in register 
15. 

System Action: None. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 
appl i cable. 



Explanation: A redundant comma was 
encountered when scanning the command, 
It is ignored. The omission of 
positional parameters cannot be 
indicated by commas; the omission of 
leading positional parameters is not 
permi tted. 

System Action: The command is 
executed. 

Operator Response: None. 

Programmer Response: Correct the 
syntax error to prevent the message 
from occurring. 



Problem Determination: 

2, 4, and 29. 



Table I, items 



ICK00222I WARNING: COMMAND-END 

DELIMITER APPEARS WITHIN 
APOSTROPHES 

Explanation: The optional command 
delimiter, a semicolon, was found 
within a quoted string. A closing 
single quotation mark may have been 
omitted. 

System Action: The usage is accepted, 
and the semicolon is treated as a 
valid character instead of a 
del imi ter . 

Operator Response: None. 

Programmer Response: Check the usage 
of the semicolon, and correct if 
necessary. 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK00204I PRECEDING COMMAND BYPASSED 
DUE TO CONDITION CODES 

Explanation: The IF-THEN-ELSE command 
sequence that was specified caused the 
command to be bypassed. When 
specifying an IF-THEN-ELSE command 
sequence, either the THEN or the ELSE 
clause is executed, and the one not 
executed is bypassed. 

System Action: The bypassed portion 
of the command sequence is checked for 
syntax errors but is not executed. 
Device Support Facilities processing 
cont i nues. 

Operator Response: None. 

Programmer Response: None. 



ICK00233I TOO MANY RIGHT PARENTHESES 
FOUND. EXCESS IGNORED 

Explanation: Too many closing 
parentheses were found at the end of 
the command or following a first-level 
parameter. 

System Action: The excess is ignored, 
and the command continues processing. 

Operator Response: None. 

Programmer Response: Remove the 
excess parentheses. 



Problem Determination: 
2, 4, and 29. 



Table I, items 
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ICK00234I WARNING: TOO FEW RIGHT 

PARENTHESES FOUND AT END OF 
COtfMAND 

Explanation: Too few closing 
parentheses were found at the end of 
the command to properly close the 
subparameter lists. 

System Action: The omission is 
accepted. Device Support Facilities 
processing of the command continues. 

Operator Response: None. 



ICK01018I ALTERNATE CCHH=X'CCCC hhhh f 
RE-ASSIGNED FOR PRIMARY 
CCHH=X*cccc hhhh f 



Programmer Response: 
command syntax. 

Problem Determination: 
2, 4, and 29. 



Correct the 

Table I, items 



ICK00700I CUU BEING PROCESSED AS 
LOGICAL DEVICE = XXXX 
PHYSICAL DEVICE = yyyy 

Explanation: The device at address 
cuu is being processed as a logical 
device type of xxxx and a physical 
device type of yyyy. 

System Action: Device Support 
Facilities processing of the command 
cont i nues . 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 

appli cable. 



ICK01016I ALTERNATE TRACK 

CCHH=X»CCCC hhhh' ASSIGNED 
TO PRIMARY TRACK 
CCHH=X f cccc hhhh* 

Explanation: An alternate track was 
assigned to a primary track because 
the primary track was marked 
defective, or was found to be 
defective by surface checking, or an 
unconditional alternate track 
assignment was requested for the 
primary track. 



System Action: 
processi ng. 



The command continues 



Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 
appl i cable. 



Explanat 

ori gi nal 
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System Action: The command continues 
processi ng. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 
appli cable. 

ICK01020I ALTERNATE TRACK 

CCHH=X f cccc hhhh" WAS 
RECLAIMED 

Explanation: An alternate track that 
was previously marked defective 
appeared to be nondefective when 
surface checking was performed. The 
track is added to the set of available 
alternate tracks. 

System Action: The command continues 
processi ng. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 

appli cable. 

ICK01021I PRIMARY TRACK 

CCHH=X'cccc hhhh' WAS 
RECLAIMED 

Explanation: A primary track that was 
previously marked defective appeared 
to be nondefective when surface 
checking was performed. The primary 
track is marked available, and the 
assigned alternate track is added back 
into the set of available alternate 
tracks. If the PRESERVE parameter was 
specified, any data written on the 
alternate track is copied back onto 
the reclaimed primary track. 

System Action: The command continues 
processi ng. 

Operator Response: None. 

Programmer Response: None. 
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Problem Determination: 

appl i cable. 



Not 



ICK01302I NO VTOC FOUND ON VOLUME, 
INITIALIZATION CONTINUES 

Explanation: During initialization* 
Device Support Facilities did not find 
a volume table of contents. Therefore* 
the program cannot identify data sets 
that should not be purged. 

System Action: The initialization 
continues and creates a volume table 
of contents on the volume. 

Operator Response: None. 

Programmer Response: if the 
initialization was performed at the 
minimal level* the data on the tracks 
is usually not destroyed, and it is 
possible to retrieve the data if 
necessary. 



Problem Determination: 

appli cable. 



Not 



ICK01307I DEFECTIVE TRACK LIST FOR 
VOLUME vol id 

Explanation: This message is the 
first line of the volume map. 
Following this line is a list of any 
tracks that were found defective 
during execution of the command. 



System Action: 

successfully. 



The command completed 



Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 
appli cable. 

ICK01308I THE FOLLOWING PRIMARY 
TRACKS MERE FOUND 
DEFECTIVE: 

Explanation: This message is a line 
in the volume map that identifies any 
primary tracks that were found 
defective during execution of the 

command. 

System Action: The command completed 
successfully. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 

applicable. 



ICK01309I THE FOLLOWING ALTERNAtE 
TRACKS MERE FOUND 
DEFECTIVE: 

Explanation: This message is a line 
in the volume map that identifies any 
alternate tracks that were found 
defective during execution of the 

command. 

System Action: The command completed 
successfully. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 
applicable. 



ICK01310I 



NO DEFECTIVE TRACKS MERE 
FOUND 



Explanation: This message is a line 
in the volume map that indicates that 
no defective tracks were found during 
execution of the command. If the 
command did not specify that all the 
tracks were to be checked* tracks that 
were not checked could be defective. 

System Action: The command completed 
successfully. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 

appl i cable. 

ICK01311I NO DEFECTIVE PRIMARY TRACKS 
WERE FOUND 

Explanation: This message is a line 
in the volume map that indicates that 
no defective primary tracks were found 
during execution of the command. This 
does not mean that no defective 
primary tracks exist if the command 
did not specify that all the primary 
tracks are to be checked. 

System Action: The command completed 
successfully. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 
applicable. 
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ICK01312I 



NO DEFECTIVE ALTERNATE 
TRACKS WERE FOUND 



Explanation: This message is a line 
in the volume map that indicates that 
no defective alternate tracks were 
found during execution of the command. 
Thi s message does not mean that no 
defective alternate tracks exist on 
the volume if the command did not 
specify that all of the alternate 
tracks are to be checked. 



System Action: 
successfully. 



The command completed 



Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 
appl i cable. 



ICK01313I VOLUME CONTAINS nnnn 

ALTERNATE TRACKS — mmmm 
AVAILABLE 

Explanation: This message is a line 
in the volume map. The volume is 
defined as having nnnn alternate 
tracks reserved; mmmm tracks have not 
been assigned to defective primary 
tracks nor have been found to be 
defective and unavailable for 
assignment. 

System Action: The command completed 
successfully. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 
appl i cable. 



ICK0131*! VTOC IS LOCATED AT 

CCHH=X*CCCC hhhh' AND IS 
XXXX TRACKS 

Explanation: This message is a line 
in the volume map that indicates the 
cylinder and track where the volume 
table of contents begins and the 
number of tracks it occupies. 



system Action: 
successfully. 



The command completed 
Operator Response: None. 



Programmer Response: None. 

Problem Determination: Not 
appl i cable. 



ICK01400I CUU ANALYZE STARTED 

Explanation: ANALYZE has started to 
execute its tests on the logical 
volume identified in the message (that 
is, on the volume whose unit address 
i s cuu) . 

System Action: Processing continues. 

Operator Response: None 



ICK01405I 



CUU ALL DATA 'MACHINE 
READABLE 1 WITHOUT ERRORS 



Explanation: The 
successfully read 
verification test 



volume was 
during the data 
(SCAN option). 



System Action: ANALYZE processing 
terminates normally, and message 
ICK406I (ICK01406I) is issued. 

Operator Response: None. (If a data 
problem prompted you to run ANALYZE, 
and if the problem persists, further 
analysis is needed according to your 
installation's procedures.) 



ICKO 14061 CUU ANALYZE ENDED 

Explanation: ANALYZE has completed 
processi ng. 

System Action: ANALYZE processing 
termi nates. 

Operator Response: None. 



ICK01407I CUU NO DRIVE PROBLEMS FOUND 

Explanation: ANALYZE successfully 
completed executing the drive tests 
and did not detect any problems. 

System Action: If the SCAN option was 
specified or defaulted, ANALYZE 
processing continues with the data 
verification test. Otherwise, ANALYZE 
processing terminates, and message 
ICK406I (ICK01406I) is issued. 

Operator Response: None. (If a data 
problem prompted you to run ANALYZE, 
and i f the problem persists, run the 
data verification test. If a drive 
problem prompted you to run ANALYZE, 
and if the problem persists, further 
analysis is needed according to your 
installation's procedures.) 



ICK01408I 



CUU DATA VERIFICATION TEST 
STARTED 



Explanation: ANALYZE has started to 
execute its data verification tests. 
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System Action: Processing continues. 
Operator Response: None. 



ICK01414I 



WRITE INHIBIT SWITCH ON, 
WRITE TESTS BYPASSED 



Explanation: An error is detected 
when ANALYZE attempts to write a 
record and fails because the "R/W" or 
"READ" switch is in the "READ" 
position, or the "READ/WRITE" switch 
position is defective. 

System Action: All tests which 
attempt to write on the CE cylinder 
are bypassed. 

Operator Response: Set the 
"READ/WRITE" switch in "WRITE" mode. 



ICK01415I INVALID UNITADDRESS, 

SYSNAME OR DDNAME SPECIFIED 

Explanation: The channel and unit 
address specified do not exist in the 
system I/O conf i gurat i on> or the 
DDNAME is incorrect, or the SYSNAME is 
i ncorrect . 

System Action: ANALYZE command 
processing is terminated. 

Operator Response: Correct the values 
specified for "cuu" in the UNITADDRESS 
parameter, or correct the DDNAME 
specified, or correct the SYSNAME 
specified, then reissue the command. 



ICK01416I UNABLE TO OPEN VOLUME 

Explanation: The volume that was 
specified cannot be OPENed. The DD 
statement could be missing or invalid, 
or the channel and unit address could 
be invalid. 



System Action: 

termi nated. 



The ANALYZE command is 



Operator Response: Correct the error, 
and reissue the command. 



ICK01417I WRITE TESTS BYPASSED: BAD 
HOME ADDRESS DETECTED ON 
C.E. CYLINDER 

Explanation: A bad home address on 
the CE cylinder was detected while 
trying to verify positioning of the 
access mechanism. 

System Action: All write-dependent 
tests are bypassed. 

Operator Response: None. 



ICK01501I INVALID DEVICE TYPE 

SPECIFIED FOR BUILDIX 
COMMAND 

Explanation: A request was made to 
change the format of a VTOC on a 
volume whose device type is not 
supported by the BUILDIX command (for 
example, a 2314 DASD). 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: Verify that the 
volume is on a device type supported 
by the BUILDIX command, and change th< 
JCL or command statement. 



ICK01502I BUILDIX FUNCTION STARTED 

Explanation: Execution of the BUILDIX 
command has begun. 

System Action: None. 

Operator Response: None. 

Programmer Response: None. 

ICK01503I CUU REQUEST RECEIVED TO 
CONVERT VTOC TO XXFORMAT 

Explanation: This message verifies 
the request for a change of VTOC 
format. '**» specifies the format 
requested — either OS or IX. 

System Action: Execution of the 
command continues. 

Operator Response: None. 

Programmer Response: None. 

ICK01504I CUU VTOC FORMAT IS 

CURRENTLY XXFORMAT, REQUEST 
ACCEPTED 

Explanation: This message verifies 
that the BUILDIX function specified on 
the command statement is valid for the 
current format of the VTOC on the 
volume. **x f identifies the format of 
the VTOC, either OS or IX. 

System Action: Execution of the 
command continues. 

Operator Response: None. 

Programmer Response: None. 



ICK01508A CUU SHOULD VTOC CONVERSION 
PROCEED? REPLY "U" TO 
CONTINUE, ELSE "C" 
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Explanation* This message permits the 
operator to verify that the user is 
authorized to request the BUILDIX 
function before execution of the 
command begins. 

System Action: The system will wait 
for the operator's reply. 

Operator Response: Verify that the 
user is authorized to issue the 
command, and reply 'U' to continue. 
Any reply other than "U" is 
interpreted as a cancellation request. 

Programmer Response: None. 



ICK01513I CUU BUILDIX PROCESSING 

COMPLETED: VTOC IS NOW IN 
**FORMAT. 

Explanation: The BUILDIX command 
completed successfully. 'xx* shows the 
new VTOC format, either OS or IX. 

System Action: Device Support 
Facilities is terminated normally. 

Operator Response: None. 

Programmer Response: None. 

ICK01600I MAPALT STARTED 

Explanation: Execution has started 
for the MAPALT command. 

System Action: None. 

Operator Response: None. 

ICK01606I nnnnn BLOCKS ASSIGNED TO 
ALTERNATES IN LIMITS 
SPECIFIED 

Explanation: This summary message 
shows the number of blocks that were 
assigned to alternates within the 
limits specified on the command 
statement . 

System Action: None. 

Operator Response: None. 

Programmer Response: None. 



ICK01608I 



CUU MAPALT ENDED NORMALLY, 
RETURN CODE= n 



Explanation: Execution of the command 
ended without any errors detected that 
would have caused termination of 
execution. A return code of or 4 
will be indicated in the message. A 
return code of means no errors were 
encountered. A return code of 4 means 
one or more recoverable errors were 
encountered. 



System Action: None. 
Operator Response: None. 
Programmer Response: None. 



ICK01609I 



PERMANENT DATA CHECK FOUND 
reading ID for BLOCK nnnnnn 



Explanation: A permanent data check 
was encountered while attempting to 
read the ID field of the primary block 
shown in the message. 

System Action: Diagnostic information 
is printed on the output device, and 
execution of the command continues. 

Operator Response: None. 

Programmer Response: Save the job 
output for the system coordinator, and 
follow installation procedures for 
data recovery and/or assignment of an 
alternate block. 

Problem Determination: Table I, items 
1, 2, 3, 4, 29. 



ICK10710I 



I/O ERROR OCURRED ON DEVICE 
CUU 



Explanation: An I/O error occurred on 
the device whose address is specified 
by cuu. The nature of the I/O error is 
described on the next two lines, where 
the failing channel command word 
(CCW), the channel status word (CSW), 
and the sense bytes are printed. 

System Action: The command continues 
processing. Eventual termination of 
the command may occur, but such a 
termination is generally followed with 
a terminating message. 

Operator Response: None. 

Programmer Response: Make sure that 
the problem is, indeed, with the 
device. Correct the device problem, 
and retry the command. 



ICK11005I VTOC DOES NOT EXIST 

Explanation: A volume table of 
contents was not found on the volume 
during execution of the command. 

System Action: A volume table of 
contents was created, and the command 
continues processing. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Not 

appli cable. 
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ICK11Q09I IPL PROGRAM SUPPLIED FOR 
MSS — IGNORED 

Explanation: A volume being formatted 
as an MSS staging pack cannot contain 
IPL records. 

System Action: The IPL program 
specified is ignored, and the command 
continues processing. 

Operator Response: None. 

Programmer Response: Remove the IPLDD 
parameter from the command. 

Problem Determination: Not 
applicable. 



ICK11010I UNABLE TO CLOSE VOLUME 

Explanation: A system error occurred 
that prevents the volume from being 
closed properly. 

System Action: The command probably 
did not complete successfully because 
the volume did not close when the 
command completed. Device Support 
Facilities processing continues with 
the next command. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Table I, items 
1 , 2, 3, 4, and 30. 



ICK11050I VTOC LOCATION SPECIFIED FOR 
MSS STAGING PACK — IGNORED 

Explanation: You cannot specify a 
VTOC location for a Mass Storage 
System staging pack. 

System Action: The VTOC parameter is 
ignored, and the command continues 
processi ng. 

Operator Response: None. 

Programmer Response: Remove the VTOC 
parameter from the command. 

Problem Determination: Not 
appl i cable. 



ICK11051I LABELS PARAMETER SPECIFIED 
FOR MSS STAGING PACK — 
IGNORED 

Explanation: You cannot place user 
volume labels on a Mass Storage System 
staging pack. 

System Action: The LABELS parameter 
is ignored, and the command continues 
processi ng. 



Operator Response: None. 

Programmer Response: Remove the 
LABELS parameter from the command. 



Problem Determination: 

applicable. 



Not 



ICK11306I NO STORAGE AVAILABLE FOR 
PACK MAP 

Explanation: During initialization or 
inspection of a volume, storage is 
dynamically acquired for data elements 
that are collected later to format the 
pack map. A data element was being 
allocated, but storage was not 
avai lable. 

System Action: The command is 
completed, but without a pack map. 

Operator Response: None. 

Programmer Response: Specify a larger 
region size, and reissue the command. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK11315I UNABLE TO READ VOLUME LABEL 

Explanation: An I/O error occurred 
when attempting to read the volume 
label. Because the number of user 
volume labels cannot be determined, 
the IPL program record could be 
written over existing records. 

System Action: The command continues 
processing, but does not write the IPL 
program records. 



Operator Response: 

Programmer Response: 
Determination. 



None. 

See Problem 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK11328I SKIP DISPLACEMENTS ASSIGNED 
TO TRACK X^OccOOhh* 

Explanation: Defective areas on the 
track have been bypassed. ICKDSF 
processing continues on nondefective 
areas of the track. 

System Action: The command continues 
processi ng. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: None. 
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I ICK11330I UNIT PARAMETER INVALID 

Explanation: The UNIT parameter is 
invalid in the current environment. 

System Action: The command 
termi nates. 

| Operator Response: None. 

Programmer Response: Correct the 
control statement, and resubmit the 
job. 



ICK20011I FUNCTION CANNOT BE 

EXECUTED. INSUFFICIENT MAIN 
STORAGE 

Explanation: There is not enough 
virtual storage available to execute a 

command. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: increase the 
amount of virtual storage available to 
Device Support Facilities and reissue 
the command. 



Problem Determination: 

1, 2, 3, and 29. 



Table I, items 



ICK20800I UNABLE TO SCRATCH dsname 

Explanation: An error occurred while 
attempting to scratch the identified 
data set. A subsequent second-level 
message identifies the error. 

System Action: The data set is not 
scratched. Device Support Facilities 
processing continues with the next 
command. 



Operator Response: 

Programmer Response 

associated message. 



None. 

See the 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK20801I XX NO VOLUME MOUNTED 

Explanation: Volume not mounted. 

System Action: The data set is not 
scratched. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Reissue the 
command and make sure the correct 
volume is mounted. 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



ICK20802I 



XX PASSWORD VERIFICATION 
FAILED 



Explanation: The data set to be 
scratched is password protected, and 
the operator did not supply the proper 
password. 

System Action: The data set is not 
scratched. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Reissue the 
command, and speci fy the correct 
password when prompted. 

Problem Determination: Table I, items 

1, 2, 3, 4, 25a, and 29. 



ICK20803I 



XX DATA SET HAS NOT EXPIRED 
on volume volser 



Explanation: The PURGE parameter was 
not specified, and the data set's 
retention period has not expired. 

System Action: The data set is not 
scratched. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Specify the 
PURGE parameter if you want to destroy 
the data set, and reissue the command. 

Problem Determination: Table I, items 
1, 2, 3, 4, 25a, and 29. 



ICK20804I 



XX PERMANENT I/O ERROR ON 
VOLUME 



Explanation: Because of an I/O error 
condition, the volume table of 
contents cannot be read. 

System Action: The data set is not 
scratched. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Either restore 
the volume or i ni ti ali ze the volume 
of f li ne. 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 
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ICK20805I XX UNABLE TO MOUNT VOLUME 
volser 

Explanation: An appropriate device 
was not available for mounting the 
volume. 

System Action: The data set was not 
scratched. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: Ensure that a 
device is available for mounting* and 
reissue the command. 

Programmer Response: None. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK20806I XX DATA SET MAS IN USE 

Explanation: The data set to be 
scratched was being used by another 
program. 

System Action: The data set is not 
scratched, and the command continues 
processi ng. 

Operator Response: Ensure that no 
other job is using the data set (do 
not specify DISP=SHR), and reissue the 

command. 

Programmer Response: None. 

Problem Determination: Table I, items 
1, 2 3, 4, 25a, 25c, and 29. 



ICK20810I 



XX INVALID RACF 
AUTHORIZATION 



Explanation: A RACF-protected data 
set resides on the volume. The volume 
cannot be purged, because the user 
does not have the correct 
authorization to scratch the data set. 

System Action: The data set is not 
scratched, and the command terminates. 
Device Support Facilities processing 
continues with the next command. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK20950I INVALID FORMAT STRUCTURE 

Explanation: An element of one of the 
static text structures is incorrect. 
Probable program error. 



System Action: The request to print a 
line is ignored. The command continues 
processing, but no output is printed. 

Operator Response: None. 

Programmer Response: Perform the 
Problem Determination actions. 

Problem Determination: Table 1, items 
2, 3, 4, and 29. 



ICK20951I OUTPUT COLUMN SPECIFIED OUT 
OF RANGE 

Explanation: An output column 
specification is outside the allowed 
print line width, for example, beyond 
column 120. Probable program error. 

System Action: This field and 
subsequent fields for the same line 
are ignored. The command continues 
processing, but no output is printed. 

Operator Response: None. 

Programmer Response: Perform the 
Problem Determination actions. 

Problem Determination: Table I, items 
2, 3, 4, and 29. 



ICK20952I EXCESSIVE FIELD LENGTH FOR 
BD OR PU CONV 

Explanation: A binary-to-decimal or 
packed-to-unpacked conversion length 
was specified greater than 15. 
Probable program error. 

System Action: The default of 15 was 
used, and the command continues 
processi ng. 

Operator Response: None. 

Programmer Response: Perform the 
Problem Determination actions. 

Problem Determination: Table 1, items 
2, 3, 4, and 29. 



ICK20953I A REDO SUB-STRUCTURE IS 
NESTED 

Explanation: A redo structure cannot 
be defined within a set of structures 
to be redone. Probable program error. 

System Action: The current redo 
operation is terminated. All 
structures are treated only once. 

Operator Response: None. 

Programmer Response: Perform the 
Problem Determination actions. 

Problem Determination: Table I, items 
3, 4, and 29. 
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ICK20954I STATIC TEXT ENTRY REQUESTED 
NOT IN MODULE 

Explanation: A request for a specific 
static text entry in a specified 
static text module could not be 
resolved. The static text index is 
incorrect, or the programmer has 
neglected to enter a message into the 
static text module. Probable program 
error. 

System Action: The request is 
ignored, and the command continues 
processi ng. 

Operator Response: None. 

Programmer Response: Perform the 
Problem Determination actions. 



Problem Determination: 
2, 3, 4, 26c, and 29. 



Table I, items 



ICK20955I 



INVALID PACKED DECIMAL 
FIELD 



Explanation: A conversion request for 
packed-to-unpacked decimal encountered 
a digit that was not in the range of 
to 9. Probable program error. 

System Action: Conversion stops for 
the current request. The command 
continues processing without the 
packed-to-unpacked conversion. 

Operator Response: None. 

Programmer Response: Perform the 
Problem Determination actions. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21000I ALTERNATE TRACK 

CCHH=X f CCCC hhhh 1 FOUND 
UNRECOVERABLE 

Explanation: While checking the track 
surface, error conditions were 
encountered that prevented the 
alternate track's home address or 
record from being rewritten to 
indicate that it is a defective track. 
Since the track cannot be marked 
defective, it cannot be used by the 
operating system. This message may 
appear if, during execution of a 
command, the read/write mode switch is 
inadvertently set to READ mode. 

For 2305 Fixed Head Storage Models 1 
and 2, this message indicates that the 
alternate track is already assigned 
and that the customer engineer should 
reset the device to replace the 
defective primary track with an 
alternate spare. To make the dynamic 



spare available again, the 2305 device 
must be initial-microprogram-loaded 
and reinitialized. 

System Action: Device Support 
Facilities processing continues, 
unless the unrecoverable track 
threshold has been reached (see 
message ICK31013I). 

Operator Response: None. 



Programmer Response: 
Determi nat i on. 



See Problem 



Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21001I 



PRIMARY TRACK 
ccHH=x f cccc hhhh f 

UNRECOVERABLE 



FOUND 



Explanation: While checking the track 
surface, error conditions were 
encountered which prevented the 
primary track's home address or record 
from being rewritten, to indicate 
that it is a defective track. Since 
the track cannot be marked defective, 
it cannot be used by the operating 
system. This message may appear if, 
during execution of a command, the 
read/write mode switch is 
inadvertently set to READ mode. 

For 2305 Fixed Head Storage Models 1 
and 2, this message indicates that the 
alternate track is already assigned 
and that the customer engineer should 
reset the device to replace the 
defective primary track with an 
alternate spare. To make the dynamic 
spare available again, the 2305 device 
must be initial-microprogram-loaded 
and reinitialized. 

System Action: Device Support 
Facilities processing continues, 
unless the unrecoverable track 
threshold is met (see message 
ICK31013I). 

Operator Response: None. 

Programmer Response: See Problem 
Determi nati on . 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK21002I INVALID VTOC ORIGIN 

SPECIFICATION FOR TRACK 
CCHH=X'cccc hhhh' 

Explanation: The VTOC parameter 
specifies an invalid track location 
for the volume table of contents. The 
VTOC cannot begin on cylinder 0, track 
or encroach on the alternate track 
area. 
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System Action: The command is 
terminated. ICKDSF continues with the 
next command. 

Operator Response: None. 

Programmer Response: Either accept 
the default location, or reissue the 
command with a correct location 
speci f i ed. 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



ICK21003I 



INVALID VTOC EXTENT 
SPECIFICATION: XXXX 



Explanation: The VTOC parameter 
specifies an invalid extent (number of 
tracks) for the VTOC area. The VTOC 
cannot have an extent of or encroach 
on the alternate track area. 

System Action: The command is 
terminated. ICKDSF continues with the 
next command. 

Operator Response: None. 

Programmer Response: Either accept 
the default extent, or reissue the 
command with a correct extent 
speci f i ed. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK21007I R-ZERO INCORRECT 

— x CCHH=X ? cccc hhhh* 

(X'cccc hhhh') 

y CCHH=X f cccc hhhh" 

Explanation: The track address 
portion of record of an alternate 
track (y CCHH=X'cccc hhhh') points to 
a primary track (x CCHH=X'cccc hhhh*), 
but the track address portion of 
record of the primary track does not 
point to that alternate track. The 
track address portion of the primary 
track's record is shown in 
parentheses. 

x and y_ are replaced by the character 
D or N indicating defective or 
nondef ect i ve, respectively. 

When scanning the primary tracks, if 
the track address portion of record 
of a primary track is incorrect, the 
Device Support Facilities program 
places FFFF : FFFF in the alternate 
track address field of the message. 



There may or may not be an alternate 
track that points to this primary 
track. 

System Action: If the alternate track 
is not marked defective, it is made 
available for assignment. Otherwise, 
the alternate track remains marked 
defective, and the primary track 
remains as found. 

Operator Response: None. 

Programmer Response: Initialize the 
volume at the medial or maximal level 
to correct the track descriptor of the 
primary track. Alternatively, inspect 
the volume and unconditionally assign 
an alternate track to the indicated 
primary track. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21008I UNABLE TO WRITE IPL RECORDS 

Explanation: The IPL program records 
could not be written. Messages printed 
just prior to this message indicate 
the nature of the error. 

System Action: The IPL program 
records are not written, but the 
command continues processing. 

Operator Response: None. 

Programmer Response: Correct the 
error, and reissue the command. 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



ICK21011I CRITICAL TRACK 

CCHH=x f cccc hhhh' 
DESCRIPTOR INCORRECT 

Explanation: The critical tracks are 
those tracks that are reserved for the 
volume table of contents and cylinder 
0, track 0. The contents of the record 
on the identified track are in 
error. 

System Action: None. 

Operator Response: None. 

Programmer Response: Reinitialize the 
volume at the medial or maximal level. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 
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ICK21014I SURFACE CHECK FUNCTION 
FAILS ON TRACK 
CCHH=X'cccc hhhh" 

Explanation: While writing or reading 
the indicated track, a channel program 
failure other than DATA CHECK 
occurred. 

System Action: An alternate track is 
assigned or reassigned if the 
specified parameters permit. If the 
specified parameters do not permit the 
assignment of alternate tracks, the 
track is not marked defective, and no 
alternate track is assigned. If the 
track cannot be written on, it is 
deemed unrecoverable, and a subsequent 
message is issued to that effect. 

Operator Response: None. 

Programmer Response: Specify the 
ASSIGN parameter if you want an 
alternate track assigned. 



ICK21030I 



NOT ALLOWED TO WRITE IPL 
RECORDS 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK21017I 



NO MORE ALTERNATE TRACKS 
LEFT ON PACK 



Explanation: All nondefective 
alternate tracks have been assigned to 
primary tracks. 

System Action: Assignment of 
alternate tracks ends; execution of 
the command continues. 

Operator Response: None. 

Programmer Response: Reinitialize the 
volume at the maximal level to attempt 
to reclaim primary and alternate 
tracks. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK21028I 



NOT ALLOWED TO CHANGE 
VOLUME LABEL 



Explanation: Only an authorized user 
can change the volume label on a 
volume in a system that has Resource 
Access Control Facility (RACF) 
i nstalled. 

System Action: The contents of the 
volume label are not changed, but the 
command continues processing. 

Operator Response: None. 

Programmer Response: None. 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



Explanation: Only an authorized user 
can change the IPL records on a volume 
in a system that has Resource Access 
Control Facility (RACF) installed. 

System Action: The IPL records are 
not written, but the command continues 
processi ng. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21031I UNABLE TO RECLAIM ALTERNATE 
TRACK CCHH=X f CCCC hnhh 1 

Explanation: An I/O error occurred 
when attempting to rewrite the home 
address and record on the indicated 
alternate track. 

System Action: The alternate track is 
not reclaimed. The command continues 
processi ng. 

Operator Response: None. 

Programmer Response: See Problem 
Determi nati on. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21032I UNABLE TO RECLAIM PRIMARY 
TRACK CCHH=X f CCCC hhhh f 

Explanation: An I/O error occurred 
when attempting to rewrite the home 
address and record on the indicated 
primary track. 

System Action: The primary track is 
not reclaimed. The command continues 
processi ng. 

Operator Response: None. 

Programmer Response: See Problem 
Determi nati on . 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21033I 



TRACK DISSOCIATION FAILED*. 
CCHH=X f cccc hhhh f 



Explanation: When reclaiming a 
primary or alternate track, the track 
addresses associating the primary and 
alternate tracks could not be removed 
because an error occurred that 
prevented correct rewriting of the 
record 0. 
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System Action: The alternate track is 
marked defect ive, and the command 
continues processing. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21037I INVALID TRACK ADDRESS 
SPECIFIED: 
CCHH=X f cccc hhhh f 

Explanation: Only tracks within the 
defined primary or alternate track 
areas of a volume can be inspected. 
The error is caused either by 
specifying a track beyond these areas 
or by a syntax error when specifying 
the track address. 

System Action: The requested action 
on the invalid track is ignored, but 
the remainder of the command continues 
processing for any tracks that were 
correctly specified. 

Operator Response: None. 

Programmer Response: Correct the 
invalid specification, and reissue the 

command. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21039I PRIMARY TRACK 

CCHH=X*cccc hhhh' 
DEFECTIVE, NO ALTERNATE — 
DATA SAVED 

Explanation: Surface checking found 
the indicated primary track to be 
defective, but no alternate track is 
available to be assigned to it. 

System Action: The contents of the 
primary track are saved and rewritten 
on the primary track, if possible. The 
command continues processing. 

Operator Response: None. 



Programmer Response: 

volume. 

Problem Determination: 
1, 2, 3, 4, and 29. 



Reinitialize the 



Table I, items 



ICK21040I PRIMARY TRACK 

CCHH=X'cccc hhhh' 
DEFECTIVE, NO ALTERNATE — 
DATA LOST 

Explanation: Surface checking found 
the indicated track to be defective, 
but no alternate track is available to 
be assigned to it. 



System Action: The contents of the 
primary track are lost and not 
rewritten on the primary track. The 
command continues processing. 

Operator Response: None. 

Programmer Response: Reinitialize the 
volume. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21041I ALTERNATE TRACK 

CCHH=X f CCCC hhhh» DEFECTIVE 
— DATA SAVED 

Explanation: Surface checking found 
the indicated alternate track to be 
defective, but no alternate track is 
available to be reassigned to it. 

System Action: The contents of the 
alternate track are saved and 
rewritten to the alternate track, if 
possible. The command continues 
processi ng. 

Operator Response: None. 

Programmer Response: Reinitialize the 

volume. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21042I ALTERNATE TRACK 

CCHH=X*CCCC hhhh' DEFECTIVE 
— DATA LOST 

Explanation: Surface checking found 
the indicated alternate track to be 
defective, but no alternate track is 
available to be reassigned to it. 

System Action: The contents of the 
alternate track are lost and not 
rewritten on the alternate track. The 
command continues processing. 

Operator Response: None. 



Programmer Response: 
volume. 



Reinitialize the 



Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21044I UNABLE TO PRESERVE — 
UNABLE TO READ TRACK 

CCHH=X'cccc hhhh* 

Explanation: A record on the 
indicated cylinder and track could not 
be read because of I/O errors. 

System Action: The record on the 
indicated track is not lost. The 
command continues processing. 
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Operator Response: None. 

Programmer Response: None. 

Problem Determination: Table I, items 

1, 2, 3, 4, and 29. 



ICK21047I UNABLE TO PRESERVE -- 
UNABLE TO WRITE TRACK 
CCHH=x*cccc hhhh' 

Explanation: An I/O error occurred 
that prevented successful write 
operations while attempting to write 
preserved records back to the original 
track or its assigned alternate track. 

System Action: The data on the track 
may have been lost* and the command 
continues processing. 



the VTOC on any other track other than 
the first track of the volume. 



Operator Response: None 



Programmer Response: 
volume. 



Reinitialize the 



Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21048I CYL-0 TRK-0 DEFECTIVE, PACK 
UNUSABLE FOR IPL 

Explanation: Cylinder 0, track has 
been found defective. The track has 
been assigned an alternate track, but 
the volume cannot be used as an IPL 
volume. 

System Action: The command continues 
processi ng. 

Operator Response: None. 

Programmer Response: Call the 
customer engineer if you must use this 
volume as an initial-program-load 
volume. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21055I VTOC IS LOCATED ON CYLINDER 
HEAD 

Explanation: The volume table of 
contents exists on the first track of 
the volume. This prevents the writing 
of IPL program records on the first 
track of the volume. 

System Action: The IPL program 
records are not written on the first 
track of the volume as requested by 
the user. Command processing 
cont i nues . 

Operator Response: None 

Programmer Response: If it is 
necessary to have IPL records on the 
volume, reinitialize the volume with 



ICK21316I 



UNABLE TO OPEN IPL INPUT 
DATA SET 



Explanation: The data set specified 
by the IPLDD parameter cannot be 
opened. An associated message 
identifies the reason for the failure. 

System Action: The command continues 
processing, but the IPL program record 
i s not wri tten . 

Operator Response: None. 

Programmer Response: Correct the 
error that was identified in the 
associated message, and reissue the 
command. 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



ICK21317I IPL INPUT RECORD-1 FORMAT 
IMPROPER 

Explanation: The first usei — specified 
IPL bootstrap record did not contain 
IPL1 as the first four characters of 
the record. 

System Action: The system-defined IPL 
bootstrap records are written on the 
volume and processing continues. The 
remainder of the usei — specified IPL 
bootstrap records and IPL program 
records are ignored. 

Operator Response: None. 

Programmer Response: Correct the IPL 
bootstrap record format and reissue 
the command, or accept the 
system-defined IPL bootstrap records. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK21318I IPL INPUT RECORD-2 FORMAT 
IMPROPER 

Explanation: The second 
usei — specified IPL bootstrap record 
did not contain IPL2 as the first four 
characters of the record. 

System Action: The system-defined IPL 
bootstrap records are written on the 
volume and processing continues. The 
usei — specified IPL bootstrap records 
and IPL program records are ignored. 

Operator Response: None. 

Programmer Response: Correct the IPL 
bootstrap record format and rei ssue 
the command, or accept the 
system-defined IPL bootstrap records. 
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Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK21322I 



ICK21319I UNABLE TO WRITE BOOTSTRAP-1 
RECORD ON VOLUME 

Explanation? An I/O error occurred 
when attempting to write the first IPL 
bootstrap record on cylinder 0> track 
0. The volume is unusable for IPL. 

System Action: The command continues 
processing, but the IPL bootstrap 
records are not written on the volume. 

Operator Response: None. 

Programmer Response: Issue the 
INSPECT command to attempt to reclaim 
the track, or reinitialize the volume. 



Problem Determination: 
2, 3, 4, and 29. 



Table I, items 



ICK21320I UNABLE TO WRITE BOOTSTRAP-2 
RECORD ON VOLUME 

Explanation: An I/O error occurred 
when attempting to write the second 
IPL bootstrap record on cylinder 0, 
track 0. The volume is unusable for 
IPL. 

System Action: The command continues 
processing, but the IPL bootstrap 
records are not written on the volume. 

Operator Response: None. 

Programmer Response: issue the 
INSPECT command to attempt to reclaim 
the track, or reinitialize the volume. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK21321I 



UNABLE TO WRITE IPL PROGRAM 
ON VOLUME 



Explanation: An I/O error occurred 
when attempting to write the IPL 
program record on the volume. The 
volume is unusable for IPL. 

System Action: The command continues 
processing, but the IPL program record 
is not written on the volume. 

Operator Response: None. 

Programmer Response: Issue the 
INSPECT command to attempt to reclaim 
the track, or reinitialize the volume. 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



CALCULATED IPL PROGRAM 
LENGTH IS EXCESSIVE 



Explanation: The total number of 
bytes required by the usei — specified 
IPL program exceeds the maximum 
permitted for the volume being 
initiali zed. 

System Action: The command continues 
processing, but the IPL program is not 
written on the volume. 

Operator Response: None. 

Programmer Response: Determine the 
cause of the excessive size, recompile 
or reassemble the IPL program, then 
reissue the command. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK21323I 



IPL PROGRAM INPUT CONTAINS 
NO TXT CARDS 



Explanation: The input records 
specified for the IPL program source 
were read, but contained no records 
that were identified as standard text 
(TXT) records. 

System Action: The IPLDD parameter is 
ignored, and the command continues 
processi ng. 

Operator Response: None. 

Programmer Response: Be sure the 
correct input is supplied in the input 
stream or in the specified data set. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK30003I FUNCTION TERMINATED. 
CONDITION CODE IS nn 

Explanation: A command has 
encountered a terminating error 
condition during execution (see 
message ICK00001I for an explanation 
of jnn) . Messages printed just prior to 
this message indicate the nature of 
the error. 

System Action: Device Support 
Facilities processing continues with 
the next command. LASTCC is set to nn ; 
MAXCC is set to nn if n_n is greater 
than the current value of MAXCC. 

Operator Response: None. 

Programmer Response: Correct the 
cause of the error, and reissue the 
command. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 
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ICK30004I FUNCTION TERMINATED. 

INSUFFICIENT MAIN STORAGE 

Explanation: The allocated virtual 
storage is too small. 

System Action: Device Support 
Facilities processing continues with 
the next command. 

Operator Response: None. 

Programmer Response: Increase the 
allocated size of virtual storage, and 
reissue the command. 

Problem Determination: Table I, items 
1, 2, 3, and 29. 



ICK30008I 



FUNCTION NOT SUPPORTED IN 
THIS ENVIRONMENT 



Explanation: The system adapter was 
entered wi th a request to perform a 
command not supported in the current 
operating system environment. Probable 
program error. 

System Action: Device Support 
Facilities processing continues with 
the next command. 

Operator Response: None. 

Programmer Response: The version of 

Device Support Facilities is not 
appropriate for the operating system 
environment. Ensure that the 
appropriate version is installed. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK30200I 



TOO MANY POSITIONAL 
PARAMETERS AFTER XXXX 



Explanation: A parameter list has too 
many positional parameters specified, 
specifically those following the 
characters xxxx . 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Remove the 

excess parameters from the command, 
and reissue the command. 



Problem Determination: 

2, 4, and 29. 



Table I, items 



ICK30201I CONSTANT XXXX EXCEEDS 
LENGTH LIMIT 

Explanation: The constant xxxx 
contains more characters than the 
maximum permitted by the command 
syntax. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
constant, and reissue the command. 

Problem Determination: Table I, items 
2, <\, and 29. 



ICK30202I ABOVE TEXT BYPASSED UNTIL 
NEXT COMMAND. CONDITION 
CODE IS 12. 

Explanation: A syntax error has been 
encountered^ the remainder of the 
command is ignored. Messages printed 
just prior to this message indicate 
the nature of the error. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
syntax error, and reissue the command. 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK30203I ITEM XXXX DOES NOT ADHERE 
TO RESTRICTIONS 

Explanation: An indicated parameter 
does not conform to the naming 
conventions required. For example, 
dname may be misspelled. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
parameter error, and reissue the 

command. 

Problem Determination: Table I, items 
2, 4, and 29. 
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ICK30205I DELIMITER XXXX IS NOT 
PROPERLY PRECEDED BY A 
CONSTANT OR KEYWORD 

Explanation! A delimiter was found 
where a subparameter list or data was 
expected. The delimiter is improperly 
used* Parentheses may be improperly 
positioned, or a positional parameter 
may be mi ssi ng. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Correct the 
syntax error, and reissue the command. 



Problem Determination: 

2, 4, and 29. 



Table I, items 



Problem Determination: 
2, 4, and 29. 



Table I, items 



ICK30207I REMAINDER OF COMMAND INPUT 
STREAM IGNORED 

Explanation: An error has occurred 
which prohibits further scanning of 
the command stream. Messages printed 
just prior to this message indicate 
the nature of the error. 

Note: The condition code (MAXCC) is 
always set to 16 when this situation 
is encountered. 

System Action: Device Support 
Facilities terminates. 

Operator Response: None. 

Programmer Response: Correct the 
error, and reissue the command. 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK30208I 



LEFT PARENTHESIS MISSING 
FOLLOWING KEYWORD XXXX 



Explanation: The keyword xxxx is not 
followed by an opening parenthesis, 
which should begin the required 
subparameter list or value associated 
with the command keyword. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Check the 
requirements of the keyword, correct 
the syntax, and reissue the command. 



ICK30209I 



RIGHT PARENTHESIS MISSING 
AFTER XXXX 



Explanation: A closing parenthesis 
was not found where expected, or a 
subparameter list was not properly 
del i mi ted. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, and reissue the 

command. 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK30210I INVALID PARENTHESES FOR 
SPECIFYING REPEATED 
SUBPARAMETER LIST 

Explanation: Parentheses that are 
used for delimiting repeated 
subparameter lists are missing or not 
matched. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, and reissue the 
command. 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK30211I KEYWORD XXXX IS IMPROPER 

Explanation: A misspelled, improperly 
specified, or inapplicable keyword was 
encountered in the command. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, and reissue the 

command. 

Problem Determination: Table I, items 
2, 4, and 29. 
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ICK30212I 



INVALID LEFT PARENTHESIS 
AFTER XXXX 



ICK30216I 



ABOVE TEXT BYPASSED UNTIL 
NEXT COMMAND 



Explanation: An opening parenthesis 
was found which appeared to delimit 
the positional parameter xxxx, but the 
positional parameter was not a 
constant or a list of constants. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command . 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, and reissue the 

command . 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK30213I KEYWORD XXXX APPEARS TOO 
OFTEN 

Explanation: The keyword xxxx has 
appeared too often in the command. A 
parameter list may be incorrectly 
speci f i ed. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax by removing the 
keyword, and reissue the command. 



Explanation: An error was encountered 
during the syntax check of this 
command, and syntax checking was 
terminated. Messages printed just 
prior to this message indicate the 
nature of the error. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, and reissue the 

command. 



Problem Determination: 

2, 4, and 29. 



Table I, items 



Problem Determination: 
2, 4, and 29. 



Table I, items 



ICK30217I PASSUORD IMPROPER AFTER 
XXXX 

Explanation: A password, denoted by a 
slash (/), was encountered where a 
password is not allowed. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Remove the 
password from the parameter, and 
reissue the command. 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK30214I HEX OR BINARY CONSTANT 
SPECIFIED IMPROPERLY 

Explanation: A hexadecimal or binary 
constant is not specified in the 
correct format: X'n' or B'n', 
respecti vely . 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, and reissue the 

command. 



Problem Determination: 

2, 4, and 29. 



Table I, items 



ICK30218I TOO MANY REPEATED 

SUBPARAMETER LISTS APPEAR 

Explanation: Too many repeated 
subparameter lists appear in the 
command. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Check the 
command syntax, correct the error, 
then reissue the command. 

Problem Determination: Table I, items 
2, 4, and 29. 
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ICK30219I VERB NAME XXXX UNKNOWN 

Explanations The verb xxxx is not 
recognized as a command. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Reissue the 
command with the correct command name. 

Problem Determination: Table I, items 
2, 4, and 29. 



Problem Determination: 
2, 4, and 29. 



Table I, items 



ICK30220I 



IMPROPER NUMERIC DIGIT 
FOUND IN XXXX 



Explanation: An invalid character was 
encountered in the constant xxxx . A 
decimal number can only be specified 
with the symbols through 9; a 
hexadecimal number can only be 
specified with the symbols through 9 
and A through F; and a binary number 
can only be specified with the symbols 
and 1. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax error* and reissue the 
command. 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK30223I 



TOO MANY CONSTANTS IN LIST 
BEGINNING AT XXXX 



Explanation: Too many constants were 
specified i n the command beginning at 
the characters xxxx . 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, and reissue the 
command. 



Problem Determination: 
2, 4, and 29. 



Table I, items 



ICK30225I REQUIRED CSUB PARAMETER OF 
XXXX IS MISSING 

Explanation: A required parameter or 
subparameter, identified by xxxx , is 
mi ssi ng. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Add the missing 
parameter, and reissue the command. 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK30221I 



CONSTANT XXXX NOT WITHIN 
VALUE RANGE 



ICK30226I 



Explanation: The value of the 
constant xxxx is outside the range of 
values allowed for the associated 
parameter. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Check the 
command syntax for allowed values, 
correct the error, then reissue the 
command. 



INCONSISTENT PARAMETERS 
INVOLVING XXXX 



Explanation: Some commands contain 
parameters that are defined as 
mutually exclusive. If one parameter 
is specified, the other parameter is 
not allowed. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, and reissue the 

command. 



Problem Determination: 

2, 4, and 29. 



Table I, items 
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ICK30300I ERROR OPENING dsname I 
ddname 

Explanation: An error occurred when 
attempting to open the indicated data 
set or volume. See the associated 
message for the cause of the error. 

System Action: See the associated 

message. 

Operator Response: None. 

Programmer Response: See the 
associated message. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK30301I ERROR CLOSING dsname 

Explanation: An error was encountered 
while attempting to close the data 
set. See the associated message for 
the cause of the error. 

System Action: See the associated 

message. 

Operator Response: None. 

Programmer Response: See the 

associated message. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK30302I ACTION ERROR ON dsname 

Explanation: This message identifies 
the name of the data set that was 
processing when the error occurred. 
See associated message for an 
explanation of the error. 

System Action: None. 

Operator Response: None. 

Programmer Response: None. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK30304I XXJCL STATEMENT MISSING 

Explanation: The DD statement that 
was identified in the DDNAME parameter 
is missing (0S/VS1, 0S/VS2). 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 



Programmer Response: Be sure the DD 
statement is in the job stream as 
specified in the command. Check the 
DDNAME for correct spelling. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK30309I 



XXRECORD XXXXX NOT WRITTEN. 
LENGTH INVALID 



Explanation: The record xxxxx was not 
written for one of the following 

reasons 1 

• The record length was greater than 
LRECL of the output data set. 

• The record length was less than 
the LRECL of the output data set 
and RECFM was F (fixed). 

Note- xxxxx is the first five bytes of 
the record in hexadecimal format. 

System Action: Device Support 
Facilities continues processing until 
four such errors occur. After four 
errors, the command continues to 
execute, but no further records are 
written to the output data set. 

Operator Response: None. 

Programmer Response: Redefine the 
data set with the correct LRECL value. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK30312I XXSYSTEM UNABLE TO OPEN 

Explanation: The DCBOFLG was not set 
ON following an OPEN SVC (OS/VS), or 
the OPEN system macro failed 
(DOS/VSE). See the associated messages 
for the cause of the error. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Perform the 
Problem Determination actions. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK30313I xxsynad.text 

Explanation: An I/O error occurred, 
The contents of the OS/VS Data 
Management Services SYNADAF error 
message are written. 
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System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Check the 
explanation of the SYNADAF message. 
Correct the error, and reissue the 
command. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK30315I 



**RECORD SIZE GREATER THAN 
32767 NOT SUPPORTED 



Explanation: The system cannot 
process a logical record whose size is 
greater than 32,767 bytes. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Change the DD 
statement to specify a LRECL length 
that is less than 32,767 bytes. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table 1 , i terns 



ICK30317I **PERMANENT I/O ERROR 

Explanation: An error was detected 
while performing an I/O operation. The 
data set name is given in the 
associated message. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Check the OS/VS 
JCL statements to be sure the data set 
was correctly defined. If the data set 
was correctly defined, a hardware 
error was encountered and the data set 
must be re-created on another I/O 
device. 



Problem Determination: 

2, 3, 4, and 29. 



Table I, items 



System Action: Processing for the 
specific data set is terminated. 
Command processing will continue if 
the opening of the specific data set 
is deemed noncritical to the main 
function performed by the command. 

Operator Response: None. 

Programmer Response: Probable user 
error. Check the DLBL statement. If 
there are no errors, contact your 
system programmer. 



ICK30320I **INVALID DEVICETYPE 

Explanation: In the DOS/VSE 
environment, the I/O adapter 
open/close routine was unable to open 
a data set, because it exists on a 
device that is not supported for 
sequential processing. 

System Action: Processing for the 
specific data set is terminated, and 
the command processing will continue 
if the opening of the specific data 
set is deemed noncritical to the main 
function performed by the command. 

Operator Response: None. 

Programmer Response: Probable user 
error. The data set does not exist on 
a valid device that is supported for 
sequential processing (SAM access 
method). Correct the situation, and 
resubmit the job. If the error 
persists, contact your system 
programmer. 



ICK30321I 



XXOPEN/CLOSE ABEND EXIT 
TAKEN 



ICK30318I 



XXINVALID DATA SET 
SPECIFICATION 



Explanation: The OPEN/CLOSE System 
Services SVC detected an error when 
opening or closing a data set. The 
ABEND message was written to the 
JOBJCL data set. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Check the ABEND 
message, correct the error, then 
reissue the command. 

Problem Determination: Table I, items 
l, 2, 3, 4, and 29. 



Explanation: In the DOS/VSE 
environment, the I/O adapter 
open/close routine was unable to open 
a data set because of an invalid 
specification of the data set in the 
DLBL statement. 



ICK30500I 



MAIN STORAGE NOT AVAILABLE, 
COMMAND TERMINATED 



Explanation: Dynamic acquisition of 
storage for control blocks and work 
areas failed. 
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System Action: The command is 
termi nated. 

Operator Response: increase main 
storage size, and resubmit the job. 



ICK30704I 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK30701I EQUIPMENT CHECK ON CUU 

Explanation: An EQUIPMENT CHECK I/O 
error occurred. 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: See Problem 
Determi nati on. 

Problem Determination: Table I, items 

1, 2, 3, 4, and 30. 



ICK30702I OPERATOR DID NOT READY 
DEVICE 

Explanation: When the operator was 
prompted by message ICK004D to make a 
device ready, the response was to 
terminate the command. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: None. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 

ICK30703I DEVICE ALREADY IN USE 

Explanation: The device referenced in 
the ICKDSF command by the UNITADDRESS 
or DDNAME parameter is already being 
used by another job. 

System Action: The device referenced 
in the ICKDSF command by the 
UNITADDRESS or DDNAME parameter is 
already being used by another job. 

Operator Response: None. 



Programmer Response: None 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



INVALID DEVICE-TYPE FOR 
FUNCTION 



Explanation: The type of device 
specified is invalid for the command 
issued. For instance, a Mass Storage 
System staging pack cannot be a 2314 
devi ce. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Reissue the 
command, and specify an appropriate 
device. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK30705I 



OPERATOR DID NOT SET DEVICE 
TO WRITE-MODE 



Explanation: During I/O operations, 
the device was found set for read-only 
mode. The operator elected to 
terminate the command in response to 
message ICK014D instead of setting the 
device to write mode. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Ensure that the 
device is in write mode, and resubmit 
the command. 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



ICK30706I 



DEVICETYPE PARAMETER 
MISSING OR ERRONEOUS 



Explanation: This message appears 
only in a stand-alone environment. The 
DEVICETYPE parameter must specify one 
of the valid device types. See 
Figure 2 on page 4 for valid device 
types. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command . 

Operator Response: None. 

Programmer Response: Correct the 
error, and reissue the command. 



Problem Determination: 

2, 3, 4, and 29. 



Table I, items 
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ICK30707I 



MIMIC MINI/EMU 
SPECIFICATION ERRONEOUS 



Explanations The number of cylinders 
specified, either for an OS/VS 
minidisk for the VM/370 environment or 
for an emulated Count Key Device on a 
fixed block device, is greater than 
the total number of primary cylinders 
that exist on the volume. 

System Action! The command terminates 
and Device Support Facilities 
continues processing with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
invalid number of cylinders in the 
MINI or EMU specification, and 
resubmit the job. 



ICK30708I DEVICETYPE PARAMETER 

REQUIRED WITH MIMIC MINI 
SPECIFICATION. 

Explanation: When you specify the 
MIMIC MINI parameter, you must also 
specify the DEVICETYPE parameter. 

System Action: The command terminates 
and Device Support Facilities 
continues processing with the next 

command. 

| operator Response: None. 

I Programmer Response: Correct the 

I command syntax, and resubmit the job. 



ICK30709I 



ACCESS DENIED TO SHARED 
DEVICE CUU BY OPERATOR 



Explanation: If the operator replies 
T to message ICK008D, this message 
appears before termination of the 
command. 

System Action: Command processing 
terminates, and Device Support 
Facilities continues processing with 
the next command. 

Operator Response: None. 

Programmer Response: Resubmit the job 
when the volume is accessible. 



System Action: Execution of the 
command is terminated. Device Support 
Facilities processing continues with 
the next command. 

Operator Response: None. 

Programmer Response: See Problem 

Determi nat i on . 

Problem Determination: Table 1, items 
1, 2, 3, 4, 29. 



ICK30712I 



XXX DEVICE TYPE 
VERIFICATION FAILED 



Explanation: During OPEN, ICKDSF was 
unable to determine the device type at 
address xxx, or the device type is not 
supported. If the sense ID CCW X f E4' 
is supported by the device at address 
xxx, then the following message is 
i ssued? 

PHYSICAL DEVICE=UNKNOWN 
SENSE ID=xxxxxxxxxxxxxx 

See the appropriate device manual for 
the sense ID information. Basically, 
the format is as follows: 



byte = X"FF f 

byte 1-3 = control unit 

bytes 4-6 = device id 



id 



If the sense ID CCW is not supported 
by the device the following message is 
i ssued*- 

PHYSICAL DEVICE=UNKNOWN 
LOGICAL DEVICE=UNKNOWN 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: The direct 
access devices supported by ICKDSF are 
listed in the Introduction. Check that 
the device specified by the 
UNITADDRESS, DDNAME, or SYSNAME 
parameter is supported by ICKDSF. If 
the device is supported by ICKDSF, 
follow the problem determination 
shown . 

Problem Determination: Table I, items 
1, 2, 3, 4, 13, 29. 



ICK30711I 



CHANNEL ERROR: 
CSW=XXXXXX xxxxxxxx 



Explanation: An unrecoverable channel 
error occurred, xx . . . xx i s a 
hexadecimal display of the last seven 
bytes of the CSW at the time of the 
error. 



ICK31004I VTOC CREATION FAILED 

Explanation: An I/O error occurred 
when attempting to write a volume 
table of contents on the volume. 

System Action: The volume table of 
contents is not written on the volume, 
and the command terminates. Device 
Support Facilities processing 
continues with the next command. 
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Operator Response: None. 



Operator Response: None. 



Programmer Response: See Problem 
Determi nat i on . 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



ICK31006I 



VOLUME LABEL CREATION 
FAILED 



Explanation: An I/O error occurred 
when attempting to write a volume 
label. 

System Action: A volume label was not 
written, and the command terminates. 
Device Support Facilities processing 
continues with the next command. 



Operator Response: 

Programmer Response: 

Determi nat i on . 



None. 

See Problem 



Problem Determination: 

4, and 29. 



Table 1, 2, 3, 



ICK31012I 



VOLID NOT SPECIFIED AND NO 
VOLUME LABEL EXISTS 



Explanation: A volume being 
initialized must either contain a 
volume label from which the old volume 
serial can be used, or the VOLID 
parameter must specify a new volume 
seri al number. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Be sure that the 
correct volume is mounted, or specify 
the VOLID parameter, and reissue the 
command. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK31013I 



UNRECOVERABLE TRACK 
THRESHOLD MET 



Explanation: The 

installation-specified threshold of 
unrecoverable tracks, set to ten by 
default, has been met. (An 
unrecoverable track is one that cannot 
be repaired by software: it is 
neither readable nor writable by the 
dri ve. ) 

System Action: The command terminates 
to prevent further damage to the disk 
pack. Device Support Facilities 
processing continues with the next 
command. 



Programmer Response: See Problem 
Determination, and notify the customer 
engi neer . 



Problem Determination: 

1, 2, 3, 4, and 30, 



Table I, items 



ICK31015I UNABLE TO READ VOLUME LABEL 

Explanation: An I/O error occurred 
when attempting to read the volume 
label to verify the volume serial 
number. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Reissue the 
command and specify the NOVERIFY 
parameter, or reinitialize the volume. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK31019I NEXT-AVAILABLE-ALTERNATE 

POINTER OR COUNTER IN VTOC 
IS INVALID 

Explanation: The value of the pointer 
to the next available alternate track 
or the count of the number of 
alternate tracks that are available is 
in error. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Reinitialize the 
volume at either the minimal or the 
maximal level . 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK31022I UNABLE TO CHANGE VOLUME 
LABEL 

Explanation: An I/O error occurred 
while attempting to change the volume 
serial number, the owner 
identification, or the address of the 
volume table of contents in the volume 
label. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
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Programmer Response: Reinitialize the 

volume. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK31023I INVALID UNITADDRESS, 

SYSNAME OR DDNAME SPECIFIED 

Explanation: The channel and unit 
addresses specified do not exist in 
the system I/O configuration, or the 
DDNAME is incorrect, or the SYSNAME is 
incorrect. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Correct the 

value substituted for cuu, or for 

djrame, or for sysxxx , then reissue the 
command. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK31024I UNABLE TO OPEN VOLUME 

Explanation: The volume that was 
specified cannot be opened. The DD 
statement could be missing or invalid, 
or the channel and unit address could 
be invalid. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Correct the 
error, and reissue the command. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



ICK31025I VOLUME NOT MOUNTED PRIVATE 

Explanation: When online 
initializing, inspecting, or 
reformatting is requested, the 
specified volume must be mounted 
PRIVATE to prevent interference by 
other jobs. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Be sure the 
volume is mounted PRIVATE, or perform 
the job offline. 



ICK31026I COMMAND INVALID FOR 
UNINITIALIZED VOLUME 

Explanation: The INSPECT and REFORMAT 
commands can only be specified for a 
previously initialized volume. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Initialize the 
volume. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK31027I 



UNABLE TO WRITE VOLUME 
LABEL DURING VTOC CREATION 



Explanation: An I/O error occurred 
when attempting to rewrite the volume 
label field that locates the volume 
table of contents. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: See Problem 
Determi nati on. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK31034I COMBINATION OF ASSIGN AND 
ALLTRACKS AND NOCHECK 
PROHIBITED 

Explanation: This combination of 
parameters is prohibited, because 
there are fewer alternate tracks than 
primary tracks on the volume. This 
combination of parameters specifies 
unconditional assignment of alternate 
tracks for all the primary tracks. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Change the 
combination of parameters, and reissue 
the command. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 
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ICK31035I UNABLE TO READ FORMAT-4 
DSCB 

Explanation: An I/O error occurred 
when attempting to read the format-4 
data set control block (DSCB) for the 
volume table of contents. This record 
is read, then rewritten, to indicate 
the location. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command . 

Operator Response: None. 

Programmer Response: Reinitialize the 

volume. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK31036I UNABLE TO INITIALIZE 2314 
MINI DISK 

Explanation: For the 2314 minidisk 
specification, initialization of less 
than 2 cylinders was requested. This 
is not acceptable because one cylinder 
is always used as a cylinder of 
alternate tracks. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Correct the 
MIMIC(MINKn) parameter and reissue 
the command. 



ICK31038I 



NO VALID TRACKS WERE 
SPECIFIED 



Explanation: If the TRACKS parameter 
specifies only invalid track 
addresses, this message indicates that 
the command was not processed. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Reissue the 
command, and specify one or more valid 
track addresses. 



Problem Determination: 

1, 2, 3, 4, and 29. 



ICK31043I NO STORAGE AVAILABLE TO 
HOLD RECORD BEING 
PRESERVED, TRACK 
CCHH=X»cccc hhhh' 

Explanation: To preserve the contents 
of a track during surface checking, 
the complete track is read into a 
dynamically allocated buffer in 
accordance with the track capacity of 
the volume. There is insufficient 
space in which to allocate this 
buffer. 

System Action: The track under 
inspection is not surface checked to 
avoid loss of data, and the command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: increase the 
available storage space, or specify 
the NOPRESERVE parameter if the data 
may be destroyed, then reissue the 
command. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK31046I UNABLE TO WRITE FORMAT-4 
DSCB AT CCHH=X f CCCC hhhh' 

Explanation: An I/O error occurred 
when attempting to update the volume 
table of contents. The address of the 
first available alternate track and 
the number of alternate tracks could 
not be written in the VTOC. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Reinitialize the 
volume and specify a different 
cylinder and track location for the 
volume table of contents, or issue the 
INSPECT command to assign an alternate 
track. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK31049I 



UNITADDRESS SPECIFIED FOR 
VOLUME MOUNTED ON-LINE 



Table I, items 



Explanation: The UNITADDRESS 
parameter is valid for offline 
processing only, but this device was 
mounted online. 
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System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Mount the volume 
offline* or specify the DDNAME 
parameter. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK31052I MINIMAL INITIALIZATION NOT 
PERMITTED FOR MSS STAGING 
PACK 

Explanation: To initialize a pack as 
a Mass Storage System staging pack, 
the VALIDATE or the CHECK parameter 
must be specified to initialize the 
pack at medial or maximal level, 
respect i vely . 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 

Programmer Response: Reissue the 
command with the VALIDATE parameter 
speci f i ed. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK31054I DEVICE NOT SUPPORTED FOR 
THE SPECIFIED FUNCTION 

Explanation: The volume that was 
specified for the command is not 
supported for the function as defined 
by the combination of parameters used, 
For example, ANALYZE is not valid for 
a 2314 device. See Figure 2 on page 4 
for other incompatible functions. 

System Action: Processing of the 
command is terminated. 

Operator Response: None. 

Programmer Response: Correct the 
control statement, and reissue the 
command. 



ICK31056I VTOC LOCATION IN VOLUME 
LABEL INCORRECT 

Explanation: The VTOC location 
specified in the standard volume label 
is incorrect. Therefore, 
addressability to the volume table of 
contents is lost. 



System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Reinitialize the 
volume, and reestablish addressability 
to the volume table of contents. 



ICK31057I INVALID DEVICE TYPE: VTOC 
INDEX NOT SUPPORTED ON THIS 
DEVICE 

Explanation: The device type is not a 
valid device type for initialization 
with a VTOC index. 

System Action: The creation of the 
VTOC index is not attempted. INIT 
command processing continues. 

Operator Response: None. 

Programmer Response: None. 



ICK31058I CUU I/O ERROR DETECTED 
DURING INDEX CREATION: 
ERROR CODE= X 

Explanation: An I/O error occurred 
during VTOC index creation processing. 
Error codes* 

1 - Error occurred in reading the 

volume label 

2 - Error occurred in reading the 

VTOC 

3 - Error occurred in writing the 

VTOC 

4 - Error occurred in writing 

index records 

5 - Index extent was violated; 

increase index size 

System Action: VTOC index creation 
processing is terminated. The DOS 
volume indicator is turned on in the 
VTOC. INIT command processing 
cont i nues. 

Operator Response: Refer the error 
indication to the system coordinator 
for Problem Determination. 

Programmer Response: None. 

Problem Determination: Table I, items 
1, 2, 3, 4, 29. 



ICK31059I INDEX STARTING LOCATION 
INVALID AS SPECIFIED 

Explanation: The INDEX parameter on 
the INIT command statement is invalid, 
The starting location, as specified, 
is not valid for one of the following 
reasons 5 
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• It caused an overlap with the VTOC 

• It defined cylinder 0, track as 
the starting location of the index 
data set 

• It was outside the physical limits 
of the device 

• The relative track specified is 
invalid for the device 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: Check the values 
specified for the INDEX parameter, and 
correct the value in error. Resubmit 
the job. 



ICK31061I CUU VTOC INDEX CREATION 

SUCCESSFUL: VOLUME NOW IN 
INDEX FORMAT 

Explanation: The VTOC index was 
successfully created on the volume. 

System Action: None. 

Operator Response: None. 

Programmer Response: None. 

ICK31062I CUU VTOC INDEX CREATION 
FAILED: RETURN CODE= 8 

Explanation: Index creation was 
unsuccessful . 

System Action: None. 

Operator Response: None. 

Programmer Response: Check the job 
output for additional information on 
the reason for job failure. 



ICK31063I UNABLE TO READ HOME ADDRESS 
BEFORE DATA SAVED FROM 
CCHH=X'cccc hhhh' 



Explanation: 

track can be 
read from th 
read operati 
specific cas 
termi nates, 
i s, where da 
(NOPRESERVE 
made to reco 
recovery gen 
the rest of 



Before the data on a 
read, the home-address is 
e specified track. This 
on failed. For this 
e, the command processing 
In every other case, that 
ta i s not preserved 
specified), an attempt is 
ver the home-address, but 
erally involves erasure of 
the track. 



System Action: Execution of the 
command is terminated. 

Operator Response: None. 



Programmer Response: Attempt to 
recover the data on the track; if 
successful, reissue the command with 
the NOPRESERVE option. An attempt will 
be made to recover the home-address. 



ICK31064I UNABLE TO READ RECORD ZERO 
BEFORE DATA SAVED FROM 
CCHH=X*cccc hhhh* 

Explanation: Before the data on a 
track can be read, the record is 
read from the specified track. This 
read operation failed. For this 
specific case, the command processing 
terminates. In every other case, an 
attempt will be made to recover the 
record 0, but recovery generally 
involves erasure of the rest of the 
track. 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: Attempt to 
recover the data on the track; if 
successful, reissue the command with 
the NOPRESERVE option. An attempt will 
be made to recover the record 0. 



ICK31300I 



VERIFICATION FAILED: 
VOLUME-SERIAL WRONG 



Explanation: 

speci f i ed and 
serial number 
volume serial 
volume label. 



The VERIFY parameter was 
the specified volume 
does not match the 
number found i n the 



System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Ensure that the 
correct volume i s mounted, correct the 
volume serial number specified in the 
command, or specify the NOVERIFY 
parameter. 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



ICK31301I 



VERIFICATION FAILED: 
OWNER-ID WRONG 



Explanation: The VERIFY parameter was 
specified, and the specified owner 
identification does not match the 
owner identification found in the 
volume label. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 
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Operator Response: None. 



Operator Response: None. 



Programmer Response: Ensure that the 
correct volume is mounted* correct the 
owner identification specified in the 
command, or specify the NOVERIFY 
parameter. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table X, items 



Programmer Response: If the unexpired 

data sets may be purged, reissue the 
command and specify the PURGE 
parameter, or process the volume 
of f 1 i ne. 



Problem Determination: 
1, 2, 3, 4, and 29. 



Table I, items 



ICK31303I UNABLE TO VERIFY 

AUTHORIZATION FOR PROTECTED 
DATA SET 

Explanation: At attempt was made to 
scratch a data set, but the user was 
not authorized to do so. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 

command. 

Operator Response: None. 



ICK31324I 



Programmer Response: Obtain the 
proper authorization, or reissue 
command in the offline mode. 



the 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



VOLUME CONTAINS VSAM DATA 
SETtS) 



Explanation: The volume being 
processed online contains one or more 
VSAM data sets. 

System Action: The data sets are npt 
destroyed, and the command terminates 
Device Support Facilities processing 
continues with the next command. 

Operator Response: None. 

Programmer Response: Use Access 
Method Services to delete the VSAM 
data sets, or initialize the volume 
offline. 



Problem Determination: 

1, 2, 3, 4, and 29. 



Table I, items 



ICK31304I SYSTEM OPERATOR DID NOT 
CONFIRM DATA SET PURGING 

Explanation: The operator replied T 
to message ICK001D. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Determine if the 
data may be purged and, if so, reissue 
the command and reply U to message 
ICK001D. 

Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK31305I UNEXPIRED OR PASSWORD 

PROTECTED DATA SET FOUND ON 
VOLUME 

Explanation: When attempting to 
initialize a volume online with the 
NOPURGE parameter specified, unexpired 
data sets or password-protected data 
sets were found that prevent 
initialization of the volume. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 



ICK31325I OPERATOR REFUSED PURGE 
PERMISSION 

Explanation: The operator responded T 
to message ICK003D. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Determine why 
the request to process was refused, 
and rei ssue the command. 

Problem Determination: None. 



ICK31326I 



IMPROPER RACF ACCESS 
AUTHORITY 



Explanation: A volume that is RACF 
protected cannot be processed unless 
the user has the proper level of 
authori zat i on. 

System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Obtain the 
proper level of authorization, or 
process the volume in offline mode. 
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Problem Determination: Table I, items 
1, 2, 3, 4, and 29. 



ICK31327I NO STORAGE AVAILABLE FOR 
MAXIMUM TRACK CAPACITY 
RECORD 

Explanation: No storage was available 
to build the bit pattern in a main 
storage buffer that would eventually 
be written on the volume during 
surface check. 

System Action: The command 
terminates. Device Support Facilities 
continues with the next command. 

Operator Response: None. 

Programmer Response: Specify a larger 
region size for the job step, and 
resubmit the job. 



ICK31329I 



SURFACE ANALYSIS CYLINDER 
COULD NOT BE READ 



Explanation: For the 3375 or 3380, an 
error occurred accessing the surface 
analysis cylinder. Skip displacement 
information could not be recovered. 

System Action: The current track is 
flagged not recoverable. Device 
Support Facilities continues 
processing on the next track. 



| Operator Response: 

I Programmer Response: 
Determination. 



None. 

See Problem 



Problem Determination: 
1, 2, 3, 4, 30. 



Table I, items 



Take the action appropriate to your 
installation's procedures for handling 
suspected equipment problems. If the 
problem recurs, contact your IBM 
Customer Engineer or Service 
Representat i ve. 

Problem Determination: Table I, items 
1, 2, 3, 4, 30. 



ICK31402I CUU ERROR READING DATA 

Explanation: ANALYZE detected data 
checks while reading data. This 
message is followed on the printer by 
a message that identifies the track 
and cylinder number on which each data 
check occurred. The cause of the 
problem could be a damaged disk 
surface or an intermittent read/write 
circuitry failure. 

System Action: ANALYZE processing 
terminates, and message ICK406I 
(ICK01406I) is issued. 

Operator Response: Depending on your 
installation's procedures, you might 
do one of the following: 

• Restore the entire volume from a 
backup volume. 

• Rebuild the track that has the 
error. 

• Assign Qn alternate track and then 
restore the track. 

• Rebuild the data set. 

Save the console output and ANALYZE's 
printer output, which contain further 
i nf ormat i on . 



ICK31401I CUU SUSPECTED DRIVE PROBLEM 

Explanation: During the drive tests, 
ANALYZE detected an error. During the 
data verification test, ANALYZE 
detected an error other than a data 
check . 



System Action: ANALYZE 
terminates, and message 
(ICK01406I) is issued. 



processi ng 
ICK406I 



Operator Response: Depending on your 
installation's procedures, you might 
do the following: 

• Restore the entire volume to 
another drive from a backup 
volume. 

• Discontinue using the drive. 

Save the console output and ANALYZE's 
printer output, which contain further 
information about the hardware 
problems. 



ICK31403I CUU DATA SCAN VALUES 

INVALID, testing terminated 

Explanation: The relative block 
numberCs), tracks, or cylinders 
specified by the LIMITS parameter are 
i nval i d. 



System Action: 
not done. 



Data verification is 



Operator Response: Specify valid 
relative block number(s), tracks, or 
cylinders in the LIMITS parameter, and 
resubmit the request. 



ICK31404I 



CUU VOLUME HAS UNFORMATTED 
DATA BLOCKS 



Explanation: An attempt was made to 
read a data block which was not 
initialized (data field not written). 

System Action: After 504 data checks, 
the ANALYZE command is terminated. 
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operator Response: Perform 
appropriate procedures to recover all 
desired data from the volume and then 
run the DOS utilities INTDK or INTDSK 
with the 'IQ' option to initialise all 
data blocks. 



ICK31410I MAIN STORAGE NOT AVAILABLE, 
TESTING TERMINATED 

Explanation: Dynamic acquisition of 
storage for work areas and control 
blocks fai led. 

System Action: ANALYZE command 
processing is terminated. 

Operator Response: Increase main 
storage size. 



ICK31411I INCORRECT DEVICE TYPE, 
TESTING TERMINATED 

Explanation: The device type 
specified for the ANALYZE volume is 
not supported by ANALYZE. 

System Action: ANALYZE processing is 
termi nated. 

Operator Response: Specify the 
correct device type in the DEVICETYPE 
keyword of the ANALYZE command, and 
execute ANALYZE again. See Figure 2 on 
page <t for valid device types. 



ICK31412I DEVICE NOT READY, TESTING 
TERMINATED 

Explanation: A condition occurred 
which caused "Intervention Required" 
to be posted in the failing CSW sense 
byte. 

System Action: The ANALYZE command is 
termi nated. 

Operator Response: Ready the drive, 
and reissue the command. 



ICK31505I CUU VTOC FORMAT IS 
CURRENTLY XXFORMAT, 
REJECTED 



REQUEST 



ICK31413I 



DATA FORMAT UNACCEPTABLE, 
TESTING TERMINATED 



Explanation: Data on the 
written in a format other 
standard format, or an i nt 
drive error occurred durin 
verification test, or the 
test was accessed by anoth 
that erased an EOD record 
read by the data verificat 
before it was reread by th 



cyli nder i s 
than the IBM 
ermi ttent 
g the data 
volume under 
er program 
after it was 
ion test and 
e test. 



System Action: 

termi nated. 



ANALYZE processing is 



Operator Response: None. 



Explanation: The format of the VTOC 
is currently the same as the format 
requested in the BUILDIX command 
statement. '**' identifies the format 
of the VTOC, either OS or IX. 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: Check the 
command statement. The format 
requested must be opposite from the 
current VTOC format as identified in 
this message. Be certain that the JCL 
DD statement correctly identifies the 
volume. Change the statement(s) where 
required, and resubmit the job. 



ICK31509I 



CUU DIRF FLAG SET IN VTOC, 
BUILDIX CANNOT PROCEED 



Explanation: An error occurred during 
VTOC processing on a previous job, 
causing the DADSM interrupt flag to be 
set in the VTOC. The VTOC is not 
accurate. 

System Action: Execution of the 
command is terminated. 

Operator Response: Prepare a job that 
will cause reconstruction of the VTOC, 
and run it against the volume. (For 
example, run an IEFBR14 job to 
allocate a temporary data set to the 
volume.) On conclusion of this job, 
resubmit the BUILDIX command. 

Programmer Response: None. 



ICK31510I CUU BUILDIX REQUEST 

CANCELLED DUE TO OPERATOR 
ACTION 

Explanation: The operator replied 
'CANCEL* to a message requiring a 
response. 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: Check with the 
operator for the reason for 
cancellation of the job. 



ICK31511I CUU CVAF ERROR: RETURN 

CODE=XX ERROR CONDITIONS 

Explanation: The common VTOC access 

facility returned to Device Support 

Facilities with a return code 

indicating either a logical error or a 
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physical error. Return codes have the 
following meanings: 



4, 12 



16 



Indicate logical errors 



Indicates an invalid index 
structure 



Indicates an I/O error 



The error condition will be printed 
only for a return code of 4 or 8. See 
Appendix B of Data Facility Device 
Support 1 User's Guide and Reference 
for more information on these error 
condi ti ons. 

System Action: Execution of the 
command terminates with the following 
conditions existing, depending on the 
return code : 

4, 8, 12 

The volume is left in OSVTOC 
format. 



16 



The volume is left as it was 
before the command was issued. 



Operator Response: None. 

Programmer Response: Refer to the 
DADSM program logic manual for a full 
explanation of CVAF return codes and 
error condition codes. 



ICK31512I CUU ERROR: SYS1.VT0CXX. IS 
A VIO DATASET. BUILDIX 
TERMINATED. 

Explanation: The index data set was 
allocated as a VIO data set and is not 
supported by the BUILDIX command. 

System Action: Execution of the 
command terminates with a return code 
of 12. The VTOC is left unchanged. 

Operator Response: None. 

Programmer Response: Ensure that 
allocation of the index data set 
specifies a permanent data set. Check 
the JCL statement that defines the 
i ndex data set and change the 
parameter. Resubmit the job. 



ICK31514I INDEXED VTOC FACILITY NOT 
ON SYSTEM. BUILDIX 
TERMINATED. 

Explanation: A request was made to 
change a VTOC to IXVTOC format, but 
the system does not contain indexed 
VTOC programming support. 



System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: None. 



ICK31515I CUU BUILDIX COMMAND FAILED. 
RETURN CODE= 8 

Explanation: An error occurred that 
caused execution of the command to be 
terminated. 

System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: Check the job 
output for messages describing the 
type of failure. 



ICK31516I CUU I/O ERROR DETECTED 
DURING VTOC CONVERSION: 
ERROR CODE= X 

Explanation: An I/O error occurred 
during BUILDIX processing. Error 
codes: 

1 - Error occurred in reading the 

volume label 

2 - Error occurred in reading the 

VTOC 

3 - Error occurred in writing the 

VTOC 

4 - Error occurred in writing 

index records 

5 - Index extent was violated; 

increase index size 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: Refer the error 
indication to the system coordinator 
for Problem Determination. 

Programmer Response: None. 



ICK31517I CUU ERROR: VOLUME IS A DOS 
STACKED PACK 

Explanation: The volume being 
processed has a VTOC on the first 
track of the volume. VTOC conversion 
is not possible on such a volume. 

System Action: Execution of the 
command is terminated. 

Operator Response: None 

Programmer Response: Correct the 

problem on the volume, possibly by 
initializing the volume with an INIT 
command. Note, however, that this will 
purge all existing data on the volume. 
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ICK31518I 



CUU ERROR: VOLUME CONTAINS 
SPLIT CYLINDER EXTENTS 



Explanation: It was found that the 
volume contains one or more shared 
extent data sets. These are not 
supported by the BUILDIX command. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: None. 

Programmer Response: None. 



ICK31519I cuu ERROR: SYS1.VT0CIX. 

DATASET NOT FOUND ON VOLUME 

Explanation: The index data set could 
not be found on the volume. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: None. ( 

Programmer Response: Check the job 
control statements to see i f a DD 
statement exists that will cause 
allocation of the index data set. If 
the statement exists, check if the 
name is specified correctly. Correct 
the error and resubmit the job. 



ICK31520I CUU ERROR: DUPLICATE INDEX 
DATASET NAME FOUND ON 
VOLUME 

Explanation: Two data sets were found 
on the volume that had names beginning 
with SYS1.VT0CIX. Only one i s allowed 
per volume. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: None. 

Programmer Response: Submit a job to 
scratch one of the data sets, or 
scratch both data sets if new index 
allocation is desired. 



ICK31521I 



CUU ERROR: INDEX DATASET 
EXTENT NOT CONTIGUOUS 



Explanation: This data set was found 
to occupy more than one extent. The 
index data set must occupy one* and 
only one, extent. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: None. 

Programmer Response: Scratch the 
invalid index data set, and resubmit 
the job with a job control statement 
that will ensure that only one extent 
is allocated to the index. 



ICK31522I INVALID DDNAME SPECIFIED 

Explanation: The DDname is incorrect 
in the command statement. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: Correct the job 
control statement, and resubmit the 
job. 

Programmer Response: None. 



ICK31524I UNABLE TO OPEN VOLUME 

Explanation: The volume specified 
cannot be opened. The DD statement 
could be missing or invalid. 

System Action: Execution of the 
BUILDIX command is terminated. 

Operator Response: Correct the error, 
and resubmit the job. 

Programmer Response: None. 



ICK31602I 



INCORRECT DEVICETYPE, 
MAPALT TERMINATED 



Explanation: The device type 
specified is not supported by the 
MAPALT command. 

System Action: Execution of the 
MAPALT command is terminated. 

Operator Response: Specify the 
correct device type in the DEVICETYPE 
keyword of the command statement, and 
resubmit the job. MAPALT can only be 
executed on fixed block devices in 
fixed block mode. 

Programmer Response: None. 



ICK31603I UNABLE TO OPEN VOLUME 

Explanation: The volume that was 
specified cannot be opened. The ASSGN 
statement could be missing or invalid, 
or the channel and unit address could 
be invalid. 

System Action: Execution of the 
MAPALT command is terminated. 

Operator Response: Correct the error, 
and resubmit the job. 

Programmer Response: None. 



ICK31604I CUU LIMITS PARAMETER 
INVALID AS SPECIFIED, 
MAPALT TERMINATED 
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Explanation: The relative block 
number(s) specified by the LIMITS 
parameter are invalid. 

System Action: Execution of the 
MAPALT command is terminated. 

Operator Response: Correct the 
value(s) in the LIMITS parameter, and 
resubmit the job. 



ICK31605I CUU UNRECOVERABLE I/O ERROR 
DETECTED, MAPALT TERMINATED 

Explanation: An unrecoverable I/O 
error (other than a data check) was 
encountered. 

System Action: Execution of the 
MAPALT command is terminated. 

Operator Response: Check the job 
output, which will contain diagnostic 
information to aid in analyzing the 
error. Execute the Device Support 
Facilities ANALYZE command as a 
Problem Determination aid, and follow 
installation procedures for recovery 
from this type of error. 

Programmer Response: None 



ICK31607I CUU MAPALT ABNORMALLY 
ENDED, REPORT MAY BE 
INCOMPLETE 

Explanation: This message is printed 
after an error has been encountered 
that caused execution of the command 
to be terminated. The report may be 
i ncomplete. 

System Action: None. 

Operator Response: Check previous 
messages on job output, and follow 
installation procedures. 

Programmer Response: None. 



ICK31611I MAIN STORAGE NOT AVAILABLE, 
MAPALT TERMINATED 

Explanation: Dynamic acquisition of 
storage for control blocks and work 
areas f ai led. 

System Action: Execution of the 
MAPALT command is terminated. 

Operator Response: Increase main 
storage size, and resubmit the job. 

Programmer Response: None. 



ICK40227I AN 'ELSE' COMMAND APPEARS 
IMPROPERLY 

Explanation: An ELSE clause appeared 
in the command without a corresponding 
IF statement. 

System Action: The remainder of the 
command is ignored. Device Support 
Facilities processing continues with 
the next command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, and reissue the 

command. 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK40228I AN 'END' COMMAND IS INVALID 

Explanation: An END statement was 
encountered without a matching DO 
statement . 

System Action: The remainder of the 
command is ignored. Device Support 
Facilities processing continues with 
the next command. 

Operator Response: None. 

Programmer Response: Correct the 
DO-END sequence, and reissue the 
command. 

Problem Determination: Table I, items 
2, 4, and 29. 



ICK40229I 



'IF' COMMAND HAS INVALID 
RELATIONAL EXPRESSION 



Explanation: The IF-THEN-ELSE 
statement sequence is incorrect. Only 
the system variables LASTCC and MAXCC 
can be specified, and the values must 
be decimal numbers from through 
99999. 

System Action: The remainder of the 
command stream is ignored. Device 
Support Facilities processing 
continues with the next command. 

Operator Response: None. 

Programmer Response: Check the 
requirements of the IF-THEN-ELSE 
statement sequence, correct the error, 
then reissue the command. 



Problem Determination: 
2, 4, and 29. 



Table I, items 
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ICK40230I 



'SET' COMMAND HAS INVALID 
ASSIGNMENT EXPRESSION 



ICK40237I TOO MANY LEVELS OF •IF" 
COMMAND NESTING 



Explanation: A SET statement has 
invalid syntax. Only the system 
variables LASTCC and MAXCC can be 
assigned values, and the values must 
be decimal numbers from through 
99999. 

System Action: The remainder of the 
command stream is ignored. Device 
Support Facilities processing 
continues with the next command. 

Operator Response: None. 

Programmer Response: Check the syntax 
requirements of the SET statement, 
correct the error, then reissue the 
command. 



Problem Determination: 
2, 4, and 29. 



Table I, items 



ICK40232I IMPROPER OR MISSING 'THEN' 
KEYWORD 

Explanation: The THEN clause of the 
IF-THEN-ELSE command sequence is 
missing or is misspelled. 

System Action: The remainder of the 
command stream is ignored. Device 
Support Facilities processing 
continues with the next command. 

Operator Response: None. 

Programmer Response: Correct the 
error, and reissue the command. 



Problem Determination: 
2, 4, and 29. 



Table I, items 



ICK40236I 



INPUT STREAM END-OF-FILE 
FOUND BEFORE END OF COMMAND 



Explanation: An end-of-file condition 
was encountered while scanning the 
command. This could be caused by 
incorrect command-continuation syntax 
or missing records in the input 
stream. 

System Action: The command 
termi nates. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, or add the missing 
records, then reissue the command. 



Problem Determination: 
2, 4, and 29. 



Table I> items 



Explanation: More than ten IF 
statements have been nested. 

System Action: The remainder of the 
command stream is ignored. Device 
Support Facilities processing 
continues with the next command. 

Operator Response: None. 

Programmer Response: Restructure the 
command stream to avoid the excessive 
nesting, and reissue the command. 



Problem Determination: 
2, 4, and 29. 



Table I, items 



ICK40999I UABORT CODE nn 

Explanation: This message indicates a 
termination error causing the Device 
Support Facilities processor to abort. 
This situation is usually caused by 
program or system errors. The message 
appears in the output listing via the 
wri te-to-programmer SVC. Code nn 
indicates the nature of the error. 



Code Meaning 

24 Text processor's print control 
table not addressed by the GDT 

28 No virtual storage available 
forJ 

• Page header line 

• Argument lists 

• Main title line 

• Footing lines 

• Print control table (PCT) 

• Initialization of the I/O 
adapter historical data and 
message area 

• Automatic (dynamic) storage 
for a module which uses 
preallocated automatic 
storage 

• A GETMAIN/GETVIS request 

• Space for STAE control block 

• Open control-block 
allocation 

• Device Information Table 
(DIT) 
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Note : The message that 
sufficient storage was not 
available could not be issued 
because the SYSPRINT data set is 
not open. 

32 Request made to process unopened 
data set 

33 Unable to cancel STAE control 

36 Processor unable to open 

SYSPRINT (or whichever DD name 
i s used to denote the 
processor's standard listing 
output data set) 

40 Invalid U-macro argument list: 

UOPEN, UCLOSE, UPUT, 

UGSPACE, UGP00L, UFP00L 

UTIME 

UVOLCHK, UWTO 

USTAE 

44 Processor is unable to produce a 
dump (the SNAP system service 
was not successful^ either the 
DSFDUMP data set could not be 
opened* or not enough storage 
was avai lable) 



52 Module not found for ULOAD 

72 Unsupported device type 

80 Invalid ACTIONKEY value 

88 Operator replied "T" to message 
ICK014D 

92 Dynamic device information table 
(DIT) does not exist. 

96 Equipment check occurred on 

device that is being processed 

System Action: Device Support 
Facilities terminates. 



Operator Response: 

programmer. 



Notify the system 



Programmer Response: Correct the 
cause of the error, and restart Device 
Support Facilities. 

Problem Determination: Table I, items 
1, 2, 3, 4, 29, and 30. 
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APPENDIX D. PROBLEM DETERMINATION TABLES 



Problem determination is the activity required to identify a 
failing hardware unit or program and to determine who is 
responsible for support. 

Problem determination is accomplished by using procedures 
specified by IBM. In some cases, these procedures may be 
initiated by a message or code that requires operator or 
programmer response. The response may include the requirement 
for additional problem-related data to be collected and will 
attempt, where possible, to indicate "probable" failure 
responsibi 1 i ty . 

Problem determination information is included (for OS/VS) for 
applicable messages and codes under the heading "Problem 
Determination." Standard problem determination actions are 
identified as items of Tables I and II. Unique actions are 
identified following the list of standard actions to be taken. 
In any case, it is intended that the specified actions be taken 
before calling IBM for support. 

TABLE I 

If the problem occurs again, follow the problem determination 
aids specified by the associated message or code before calling 
IBM for support j 

1. If MSGLEVEL=(1,1) was not specified in the JOB statement, 
specify it and rerun the job. 

2. Save the console sheet from the primary console. In systems 
with remote consoles, save the remote console sheet. In 
systems with Multiple Console Support (MCS), save a copy of 
the hard copy log. 

3. Save the job stream associated with the job. 

4. Save the system output (SYSOUT) associated with the job. 

5. Make sure that the failing job step includes a : 

a. SYSABEND DD statement 

b. SYSUDUMP DD statement 

c. PLIDUMP DD statement 

d. SYSMDUMP DD statement 

6. Make sure that the PARM parameter of the EXEC statement 
specifies the following: 



a . 


MAP 


b. 


LIST 


c. 


DIAG 


d. 


MSG=AP 


e. 


CORE, if applicable 


f . 


XREF 


g. 


DUMP 



If SMP is used to make all changes to the system, run the 
LIST CDS and LIST PTFBY functions of SMP to obtain a list of 
the current maintenance from the SMP control data set (CDS). 
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If any changes are made to the system without using SMP, run 
the LISTIDR function of the AMBLIST or HMBLIST service aid 
program to obtain a list of all members with a PTF or local 
fix* and save the output. Run the program against the* 

a. SYS1.LINKLIB data set 

b. SYS1.SVCLIB data set 

c. Library containing the program that issued the message 

d. SYS1.LPALIB data set 

8. Run the IMCJOBQD (stand-alone) or IMCOSJQD (system-assisted) 
service aid program to obtain a formatted copy of the 
contents of the SYS1 .SYSJOBQE or SYS1.SYSWADS data sets, 
SWADS or the resident job list. 

9. Run the AMBLIST or HMBLIST service aid program to obtain: 

a. An object module listing, specifying the LISTOBJ 
f unct i on 

b. A load module map and cross-reference listing, 
specifying the 0UTPUT=B0TH option of the LISTLOAD 
f uncti on 

10. Have a copy of the Message Control Program (MCP) available. 

11. Run the AMDSADMP or HMDSADMP service aid program to dump the 
contents of real storage and page data sets on magnetic 
tape. 

After restarting the system, process the appropriate 
function of the AMDPRDMP or HMDPRDMP service aid program to 
print the required portion of the dump tape produced by that 
program. 

Save both the tape from the AMDSADMP or HMDSADMP service aid 
program (should further information from the tape be 
required) and the listing from the AMDPRDMP or HMDPRDMP 
service aid program. 

12. Run the SEREP program, and save the resulting output. 

13. Save all the associated output. 

14. The normal response to this message requests the programmer 
and/or operator to run a specific program. Save all output 
from that program. 

15. Save the program listing associated with the job. 

16. Save the dump. 

17. Have the system-generation (SYSGEN) output available from: 

a. Stage I 

b. Stage II 

18. Run the IFCEREP1 service aid program to dump the SYS1.L0GREC 
data set and save the resulting output. For MSS, run the 
following program to dump the SYS1.L0GREC data set. 

a. Service aid IFCISDAO 

b. Program ISDASDAO with the DETAIL(ALL) parameter 

19. Save the assembly listing associated with the job. 

20. Save the control cards associated with the job. 
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21. Save the compiler output associated with the job. 

22. Save the source input associated with the job. 

23. Save the source program listing associated with the job. 

24. Run OLTEP diagnostics for the problem device and save the 
output. 

25. Run the IEHLIST system utility program to obtain a list of 
the: 

a. Volume table of contents of the associated volume* 
specifying the FORMAT option 

b. Volume table of contents of the associated volume* 
specifying the DUMP option 

c. Directory of the associated data set 

d. System catalog (if it is not a VSAM catalog) 

26. Run the IEBPTPCH data set utility to print the: 

a. Directory of the applicable data set 

b. Applicable data set 

c. Applicable member 

d. Applicable procedure 

27. Have the linkage editor/loader map available. 

28. Save the associated volume. 

29. Contact IBM for programming support. 

30. Contact IBM for hardware support. 

31. Save the trace output data set. 

32. Print the GTF trace data set with the AMDPRDMP or HMDPRDMP 
service aid program using the EDIT statement. 

33. Print the associated SVC dump data set, with the AMDPRDMP or 
HMDPRDMP service aid program using the GO statement. 

34. Issue the Access Method Services LISTCAT command to list: 

a. The contents of the applicable catalog 

b. The catalog entries for the applicable objects and any 
related objects 

35. Issue the following Access Method Services command: 

a. The MSS LISTMSF command for mountable volumes 

b. The MSS LISTMSF command with the CARTRIDGES parameter 

c. The PRINT command to list the contents of the mass 
storage volume control inventory data set 

d. The LISTMSVI command 

e. The LISTMSF command with the ALL parameter 

36. Issue the Access Methods Services PRINT command to print the 
repair workfile. 
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37. Run the AMASPZAP or HMASPZAP service aid program using the 
ABSDUMP statement to print the contents of the applicable 1 

a. Data set 

b. Track, and save all associated output 

38. Issue the Access Method Services AUDITMSS command with the 
following- 

a. The CHECK parameter 

b. The MAP parameter 

c. The READLABEL parameter 

39. Issue the Access Method Services CHECKMSS command. 

40. Issue the Access Method Services COMPARET command. 

41. Issue the Access Method Services DUMPMSS command to dump the 
f ollowi ng : 

a. Formatted mass storage control storage 

b. Mass storage control main storage 

c. Mass storage control extended storage 

d. Formatted Staging Adapter storage 

e. Staging Adapter main storage 

f. Staging Adapter extended storage 

g. Mass storage control tables 

42. Save the latest output from the Mass Storage Control Table 
Create program. 

43. Display the units for devices associated with the problem 
area. If a specific unit or units are not known, display the 
range of all virtual units. See your path chart for address 
ranges. 

44. Obtain the RACF profile of the associated data set where 
appl i cable. 

45. Stop the processing unit and use the hardware ALTER/DISPLAY 
facility to display 1 

a. All general purpose registers 

b. The page status word 

c. Main storage locations 0—200 (hexadecimal) and 7000—7080 
(hexadecimal) 

46. If the AMDSADMP or HMDSADMP program resides on tape, save 
the tape. If it resides on disk, use the DUMP feature of the 
IEHDASDR program to print the SYS1 .PAGEDUMP data set and 
cylinder 0, track of this residence disk. 

47. Save the output (listings) of the stage 1 and stage 2 
AMDSADMP or HMDSADMP initialization jobs. 

48. Follow the procedures for item 9b of this table for load 
modules A/HMDSAPGE, A/HMDSAPRO, and A/HMDSALDR of 
SYS1.LINKLIB. Use IEBUPDTE or IEBPTPCH to print the 
A/HMDSADMP and A/MDSADM2 macros from SYS1.MACLIB. 

49. Save the AMDSADMP or HMDSADMP dump output (tape or listing). 
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50. If the program seems to be looping, use the display PSW 
feature of the hardware ALTER/DISPLAY facility along with 
the hardware Instruction Step facility to trace the loop, 
instruction by instruction. 

51. If there is an error in the contents of a page data set 
dump, restart the system using a different page data set, 
then dump the original page data set using the DUMP feature 
of IEHDASDR. 

52. Use IEBCOPY to unload SYS1 . IMAGELIB to tape. 

53. Have a list of RACF-defined entities available. 



TABLE II— GTF for Problem Determination 

Format 1: Tracing Without Prompting for Event Keywords 

Before reproducing the problem, have the system operator issue 
the START GTF command specifying the tape output, M0DE=EXT, and 
TIME=YES. In response to the AHL100A or HHL100A message, the 
operator should type TRACE=opt, where opt is the trace option 
indicated for the particular message or code, within the text of 
the reply. 

When data for the problem has been recorded, run the AMDPRDMP or 
HMDPRDMP service aid program using the EDIT statement to format 
the trace output, specifying DDNAME= (ddname of the trace data 
set). 

Format 2: Tracing With Prompting for Event Keywords 

Before reproducing the problem, have the system operator issue 
the START GTF command specifying tape output, M0DE=EXT, and 
TIME=YES. In response to the AHL100A or HHL100A message, the 
system operator should specify the trace options indicated for 
the associated message or code within the text of the reply. 
Then, in response to the AHL100A or HHL100A message, the system 
operator should specify the event keywords also indicated with 
the associated message or code. 

When data for the problem has been recorded, run the AMDPRDMP or 
HMDPRDMP service aid program using the EDIT statement to format 
the trace output, specifying DDNAME= (ddname of the trace data 
set). 

Format 3: specialized Tracing Action 

Before reproducing the problem, have the system operator issue 
the START GTF command specifying tape output, M0DE=EXT and 
TIME=YES. In response to the AHL100A or HHL100A message, the 
system operator should type ' TRACE=SYS,USR' . The DD statement 
for a data set in error should specify DCB=DIAGNS=TRACE. 

When data for the problem has been recorded, run the EDIT 
function of AMDPRDMP or HMDPRDMP service aid program, specifying 
the options SYS and USR=FFF. 

Format 4: Specialized Tracing Action for VSAM 

Before reproducing the problem, have the system operator issue 
the START GTF command specifying tape output, M0DE=EXT and 
TIME=YES. In response to the AHL100A or HHL100A message, the 
system operator should type *TRACE=SYS, USR' . The DD statement 
for a data set in error should specify AMP=TRACE. 

When data for the problem has been recorded, run the EDIT 
function of the AMDPRDMP or HMDPRDMP service aid program, 
specifying the options SYS and USR=( FFF, FF5) . 
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APPENDIX E. THE VTOC INDEX 



The VTOC index is a separate* sequential data set containing 
four record types that give information on volume and VTOC 
status. Systems that contain and use indexed VTOC programming 
support can realize performance improvements in the areas of 
volume space management and I/O operations to the VTOC. 

The INIT and BUILDIX commands will build the VTOC index on 
eligible count key data devices. The INIT command creates the 
index during volume initialization in both operating system and 
stand-alone environments. The BUILDIX command, which requires 
that the host operating system contain indexed VTOC programming 
support, builds VTOC indexes on volumes currently in use on the 
system. Both commands prepare the VTOC on the target volume to 
indexed VTOC (IXVTOC) format. 

The four record types in the index provide the system with a 
comprehensive means of space management compared to nonindexed 
methods. The four record types are? 

1. The VTOC index map (VIXM) is the record that maps the index 
itself. It contains a one-foi — one bit map of the records in 
the index, showing which records are in use (bit set to one) 
and which records are free to be assigned (bit set to zero). 
The programs reserve index space for a maximum of two VIXMs. 

2. The VTOC pack space map (VPSM) contains separate bit maps 
for management of space on the volume at both cylinder and 
track level. Free and allocated space is represented in 
these maps. A maximum of five VPSMs are reserved by the 
programs. 

Note: The VPSM is built using the information in the 
format-4 DSCB which gives the number of cylinders on the 
volume as the sum of the primary cylinders plus the number 
of alternate cylinders. This value is shown in the VPSM. 
However, the alternate cylinders as well as all other unused 
bits in the bit maps are marked as allocated. 

3. The VTOC map of DSCBs (VMDS) contains a bit map showing free 
(bit set to zero) and allocated (bit set to one) data set 
control blocks in the VTOC. A maximum of two VMDSs are 
reserved. 

4. The VTOC index entry record (VIER) contains pointer entries 
to each format-1 DSCB in the VTOC. Entries are built in the 
VIER using the DSCB key (data set name) and the disk address 
(cylinder, head, record number) of the format-1 DSCB. The 
number of VIERs is variable to the maximum of total index 
records reserved minus the records used by the other three 
record types. 



CALCULATING THE SIZE OF THE VTOC INDEX 



The size of the index data set depends upon J 

1. The size of the volume (total number of cylinders and 
tracks) 

2. The track length (in bytes) 

3. The number of tracks occupied by the VTOC 

For the INIT command, the user may calculate the number of 
tracks to reserve for the index and place that value as the 
third, optional subparameter of the INDEX parameter; or the 
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third subparameter may be omitted and the program allowed to 
calculate the size of the index. For the BUILDIX command* the 
user must calculate the size of the index. 

In calculating the size of the index, the INIT command 
determines the number of VIXM, VPSM, and VMDS records needed 
(not exceeding the extablished maximum for each type), and 
assumes that all VTOC DSCBs are (or could be) format-1 DSCBs and 
that each VIER manages a maximum of 48 format-1 DSCBs. 

For efficient use of DASD space, it is recommended that you 
calculate the number of tracks to reserve for both the VTOC and 
the index data set. Figure 16 shows the maximum values for VTOC 
and VTOC index size for the devices that can support the VTOC 
index. It is not likely that the assumptions used to generate 
the chart would be valid in an actual situation. However, the 
chart places the upper limits for calculating maximum usable 
space. Space reserved above these limits is wasted. 



DEVICE 


CYLS 


TRKS 

PER 

CYL 


DSCBS/ 
TRK 


INDEX 
RECS/ 
TRK2 


MAX. 

VTOCl 

(TRKS) 


MAX. 

INDEX* 

(TRKS) 


# OF RECORD TYPES 1 * 


PR1 


ALT 


VPSM* 


VMDS 6 


VIER* 


2305-1 


48 


1 


8 


18 


5 


21 


3 


1 


1 


8 


2305-2 


96 


1 


8 


34 


6 


23 


4 


1 


1 


17 


3330 


404 


7 


19 


39 


6 


192 


27 


1 


1 


156 


3330-11 


808 


7 


19 


39 


6 


384 


53 


2 


1 


312 


3340 (35MB) 


348 


1 


12 


22 


3 


181 


29 


1 


1 


82 


3344 

3340 (70MB) 


696 


2 


12 


22 


3 


363 


56 


1 


1 


163 


3350 (native) 


555 


5 


30 


47 


8 


347 


42 


2 


2 


328 


3375 


959 


1 


12 


51 


14 


222 


20 


1 


1 


272 


3380 


885 


1 


15 


53 


18 


246 


15 


1 


1 


267 


1 This maximum value assumes that all data sets on the volume are single 

track data sets. 
2 Index record length of 2048 bytes. 

3 This maximum value assumes that the VTOC is the maximum size. 
4 The first VIXM map will manage up to 7840 index records. (One VIXM is 

more than sufficient for current devices.) The second VIXM will manage 

an additional 16032 records. 
5 The number of VPSMs required for a device is dependent upon its size. 

16032 bits are available for cylinder and track mapping in each VPSM 

(a maximum of 5 VPSMs is currently reserved). 
Hhe first VMDS will manage 16032 DSCBs. The second (and last) VMDS 

will manage an additional 16032 DSCBs. 
7 Each VIER is assumed to contain 48 entries (pointers to each Format-1 

DSCB). 



Figure 16. Table of Maximum VTOC and VTOC Index Sizes 

To calculate VTOC size, you generally determine the maximum 
number of data sets that will reside on the volume. The number 
of VTOC tracks to reserve can be easily calculated by dividing 
this number by the number of DSCBs per track, rounding to the 
next higher track. 

To calculate the number of tracks to reserve for the index, 
first multiply the number of VTOC tracks by the number of DSCBs 
per track> giving the total possible DSCBs. This number, divided 
by 48 and rounded to the next higher number, will be the 
estimated maximum number of VIERs to reserve. For the number of 
VIXM, VPSM, and VMDS records, refer to the chart for actual 
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numbers. (Note that the 3330-11 and 3350 will always require two 
VPSMs, and a 3350 with a maximum-size VTOC will require two 
VMDSs.) Add together the totals of all four record types and 
divide by the number of index records per track, rounding to the 
next higher track, to get the number of tracks to reserve for 
the index. 

The value calculated for the index size is to be placed as the 
third subparameter of the INDEX parameter on the INIT command 
statement; or it is to be placed as the number of tracks to be 
allocated in the SPACE or ABSTR parameter in the DD statement 
required to execute the BUILDIX command. 
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INDEX 



The entries in this index are shown as 
they appear in the text of the book; 
that is, words that appear in all 
uppercase in the text are also spelled 

that way here. 



abbreviating commands and 


parameters 23 


abbreviations of commands 


INSPECT 62 


REFORMAT 75 


abbreviations of paramete 


ALLTRACKS 63 


ASSIGN 67 


BOOTSTRAP 55,80 


CHECK 49,65 


DDNAME 28,40,47,63,75 


DEVICETYPE 48,64,73 


DETAIL 73 


DOSVTOC 51 


IPLDD 54,79 


IXVTOC 41 


LABELS 52 


LIMITS 29,72 


OSVTOC 41 


OWNERID 52,77 


PURGE 41,48,76 


PRESERVE 66 


RECLAIM 50,65 



28,46,62,72,75 



reserving 
(CKD 



of, 



SCAN 28 
SYSNAME 72 
TRACKS 63 
UNITADDRESS 
VALIDATE 49 
VERIFY 47,64,76 
additional volume labels, 

space for (INIT) 52 
alternate track associations 

devices) 82 
alternate tracks 

inspecting a volume for conditional 
assignment of, 
example (INSPECT) 68 
inspecting a volume for 
unconditional assignment 
example (INSPECT) 68 
inspecting to assign 61 
number of detects before 

assignment 46,61 
specifying assignment of 
(INSPECT) 67 
ANALYZE command 
assumptions 26 
data verification test 27 

messages 39 
description 3,5,25-30 
diagnostic messages 32,35 
drive test 26 

messages 35-37 
examples 30-32 
fixed head error table 34 
mapping head numbers 38 
movable head error table 33 
parameter descriptions 28-30 
syntax 28 



using output 25 

what tested 26 
analyzing a volume in a 

DOS/VSE environment, 

example 31 
APF 

(Authorized Program Facility) 
ASSGN statement (DOS/VSE) 16 
assigning alternate tracks 

(INSPECT) 67 
Authorized Program Facility 9 
auxiliary storage requirements 



bootstrap records 

IPL 86 

writing IPL 
INIT 55 
REFORMAT 79 
Building a VTOC Index, 

(BUILDIX) 43-44 
BUILDIX command 

description 40 

examples 42-44 

syntax 40 



examples 



CARD, input device specification 
Caution* NOPRESERVE parameter 

(INSPECT) 66 
Changing a VTOC format (BUILDIX) 
IXVTOC TO OSVTOC 41 
OSVTOC TO IXVTOC 41 
checking surface of the volume 
INIT 49 
INSPECT 65 
command execution, controlling 
commands 

abbreviating 23 
ANALYZE 3,4,25-30 

data verification test 

messages 3 9 
diagnostic messages 
drive test 26 
drive test messages 
examples 30-32 
fixed head error table 
mapping head numbers 38 
movable head 
syntax 28 
BUILDIX 40-44 
descri pt i on 
examples 42 
syntax 40 
comments 23 
delimiters 23 
INIT 6,45-60 

description 6,45 
examples 57-60 
syntax 46 
INSPECT 6,61-70 
descri pti on 6,61 



13 



16 



32,35 
35-37 
34 
error table 33 



40 
•44 
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examples 68-70 
syntax 62 
MAPALT 6,71-74 
description 6,71 
examples 74 
syntax 72 
line continuations 20,23 
REFORMAT 6,75-81 
description 7,75 
examples 80-81 
syntax 75 
terminator 23 
usage table 4 
condition codes to control command 

execution 16 
conditional assignment of alternate 
tracks, inspecting in online mode 
(OS/VS), example (INSPECT) 68 
continuation lines, IF statement 20 
IF-THEN-ELSE statement 
sequence 17-20 
cylinder 0, track layout 85 






data, preventing destruction 

during inspection (INSPECT) 66 
data set security and protection 

APF 9 

in a stand-alone environment 7 

in an offline mode (OS/VS) 7 

in an online mode (OS/VS) 8 

in DOS/VSE 9 
data set, printed output 15 
data verification test messages 

(ANALYZE) 39 
date, specifying when loading 
Device Support Facilities 
program 13 
defect ski ppi ng 

INIT 46 

REFORMAT 61,63,65 
defective tracks 

inspecting for, INSPECT 61 

reclaiming (INIT) 50 

reclaiming (INSPECT) 65 
delimiters 23 

identifying the type (DEVICETYPE) 
INIT 48 
INSPECT 64 
Device Support Facilities commands* 

list of 4 
Device Support Facilities messages* 

Appendix C ICK 90-136 
device where the volume is mounted* 
identifying (UNITADDRESS) 
ANALYZE 28 
INIT 46 
INSPECT 62 
MAPALT 72 
REFORMAT 75 
diagnostic messages (ANALYZE) 
direct-access storage devices 

supported 2,4 
DO clause, IF statement 17,18 
DOSVTOC parameter, INIT 51 



7-9 



32,35 



ELSE clause 

IF statement 17,18 

null 18 
emulated partial disk, 

initializing at the minimal 

level in DOS/VSE 60 

inspecting an 70 
emulation of count key data 

device on a fixed block 

architecture device 56 
END clause, IF statement 17,19 
err4J^-cxmdliLio.ns in stand-alone 

environment 13 
error tables (ANALYZE) 

fixed head 34 

moveable head 33 
examples using the Device Support 
Facilities commands 23 

ANALYZE command 30-32 

BUILDIX command 42-44 

INIT command 23,57-60 

INSPECT command 68-70 

MAPALT command 6,74 

REFORMAT command 80-81 
exclusive control 

OS/VS 9 

DOS/VSE 9 
EXEC statement, executing Device 
Support Facilities 

in OS/VS 14 

in DOS/VSE 16 
executing Device Support 
Facilities 11-16 

in a stand-alone environment 11-14 

in DOS/VSE 16 

in OS/VS 14-15 

job control language 15 

loading the program 11 
execution of command, controlling 16 
existing data, writing over on 
previously initialized volume 
(INIT) 48 






fixed head error table 
(ANALYZE) 34 



general layout of a volume 82 






home address 

standard format 86 
validating (INIT) 49 
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i denti fyi ng 

the console 12 

the device where the volume is 
mounted 
ANALYZE 28 
BUILDIX 40 
INIT 46 
INSPECT 62 
MAPALT 72 
REFORMAT 75 
the input device 12 
the output device 13 
the type of device (DEVICETYPE) 
INIT 48 
INSPECT 64 

restriction 64 
MAPALT 73 
REFORMAT 75 
IF statement 17-20 

continuation lines 20 
nested IF statement 18 
IF-THEN-ELSE statement, example 20 
IF-THEN-ELSE statement sequence 17-20 
Index, The VTOC (Appendix E) 143 
Indexed VTOC (IXVT0C) 41 
INDEX parameter (INIT) 51 
INIT command 

description 6,45-60 
examples 57-60 
syntax 40 
initialization 

maximal level 46 
medial level 45 
minimal level 45 
initializing a minidisk in stand-alone 

environment, examples (INIT) 59,60 
initializing an emulated partial disk 
at the minimal level in the DOS/VSE 
environment, example 60 
initializing a volume 6,45-57 
at medial level as Mass Storage 
System Staging Pack, 
example (INIT) 59 
at the maximal level in a 
stand-alone environment, 
example (INIT) 58 
at the medial level in a 
stand-alone environment, 
example (INIT) 58 
at the minimal level in the 
DOS/VSE environment, 
example 60 
at the minimal level in online 
mode (OS/VS), 
example (INIT) 58 
for the first time in offline 
mode (OS/VS), 
example (INIT) 57 
initializing a volume with an 

index (OS/VS) 60 
initializing two volumes in 

offline mode (OS/VS), (INIT) 59 
input devices supported in 

stand-alone environment, list of 12 
INSPECT command 
description 6,61 
examples 68-70 
syntax 62 



inspecting a minidisk 

stand-alone environment, 
examples 69 
inspecting a volume 

for conditional assignment of 
alternate tracks in online 
mode (OS/VS), 
example (INSPECT) 68 
for defective tracks 

(INSPECT) 62 
for unconditional assignment of 
alternate tracks in offline 
mode (OS/VS), 
example (INSPECT) 68 
to assign alternate tracks 67 
to reclaim tracks 62 
to reclaim tracks (INSPECT), 
examples 
in offline mode (OS/VS) 69 
in DOS/VSE 69 
inspecting an emulated partial 

disk (DOS/VSE), example 70 
inspecting an entire volume to 
produce a volume map in a 
stand-alone environment, 
example (INSPECT) 69 
IPL bootstrap records 
contents 79,86 
wri ti ng 
INIT 54 
REFORMAT 80 
IPL program 

maximum sizes by device type 
(INIT) 53 
(REFORMAT) 78 
reformatting to add, 

example (REFORMAT) 81 
writing a usei — supplied 

(INIT) 53-55 
writing a user-supplied 
(REFORMAT) 79-80 
IXVTOC (Indexed VTOC) 41 






job control language, to execute 
Device Support Facilities 
program 14,15 
JOB statement, executing Device 
Support Facilities 
in OS/VS 14 
in DOS/VSE 16 
JOBCAT DD statement, executing Device 
Support Facilities 15 



labels, writing over usei — volume 

(REFORMAT) 76 
legend of a volume map 83 
line continuations 23 
load module, location of 8 
loading the Device Support 

Facilities, specifying date 

and time of day 12 
loading the Device Support 

Facilities program 11 
identifying the console 12 
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identifying the input device 12 
identifying the output device 13 
location, volume table of contents* 

specifying (INIT) 50-51 
location, VTOC index, 
specifying (INIT) 51 



main storage requirements 3 
map 

example 83 
pri nti ng 
INIT 57 
INSPECT 66 
MAPALT command 71-74 
description 6,71 
examples 74 
syntax 72 
MAPS, index space 
VIXM 143 
VMDS 143 
VPSM 143 
maximal level initialization 46 
in a stand-alone environment, 
example (INIT) 58 
maximum sizes for IPL program 
by device type 
INIT 53 
REFORMAT 78 
Maximum sizes for VTOC and 

VTOC index, table 144 
medial level initialization 45 
in a stand-alone environment, 
example (INIT) 58 
messages, Device Support 
Appendix C ICK 



Faci li ti es, 



90-136 
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